Android SDK

1repositories {
2    mavenCentral()
3}
4
5dependencies {
6    implementation("in.sabpaisa:sabpaisa-pg:1.1.0")
7}

1dependencies {
2    implementation 'in.sabpaisa:sabpaisa-pg:1.1.0'
3}

1import `in`.sabpaisa.pg.SabPaisaClient
2import `in`.sabpaisa.pg.SabPaisaConfig
3
4val config = SabPaisaConfig(
5    apiKey     = "your-api-key",
6    merchantId = "your-merchant-id",
7    secretKey  = "your-secret-key",
8    clientCode = "your-client-code",
9    env        = "staging"           // or "production"
10)
11
12val sabpaisa = SabPaisaClient(config)

1import in.sabpaisa.pg.SabPaisaClientJava;
2import in.sabpaisa.pg.SabPaisaConfig;
3
4SabPaisaConfig config = new SabPaisaConfig(
5    "your-api-key",      // apiKey
6    "your-merchant-id",  // merchantId
7    "your-secret-key",   // secretKey
8    "your-client-code",  // clientCode
9    "staging",           // env — or "production"
10    null                 // baseUrl  (optional)
11);
12
13SabPaisaClientJava sabpaisa = new SabPaisaClientJava(config);
14
15// When done:
16sabpaisa.close();

1val params = CreatePaymentRequest(
2    merchantTxnId  = "ORDER-$orderId",
3    amount         = 50000,
4    customerName   = "Ravi Kumar",
5    customerEmail  = "[email protected]",
6    customerMobile = "9876543210",
7    udfFields      = mapOf(
8        "udf1" to "campus-north",
9        "udf2" to "semester-6",
10        "udf3" to "hostel-block-A",
11        "udf4" to "engineering",
12        "udf5" to "tuition-fee"
13        // ... up to udf20
14    )
15)

1Map<String, String> udfFields = new HashMap<>();
2udfFields.put("udf1", "campus-north");
3udfFields.put("udf2", "semester-6");
4udfFields.put("udf3", "hostel-block-A");
5udfFields.put("udf4", "engineering");
6udfFields.put("udf5", "tuition-fee");
7// ... up to udf20
8
9CreatePaymentRequest params = new CreatePaymentRequest(
10    "ORDER-" + orderId, 50000, "Ravi Kumar", "[email protected]", "9876543210",
11    "INR", null, null, null, udfFields
12);

1// Kotlin
2enquiry.data.udfData?.forEach { (k, v) -> Log.d("SabPaisa", "$k = $v") }

1// Java
2if (r.getData().getUdfData() != null) {
3    r.getData().getUdfData().forEach((k, v) -> Log.d("SabPaisa", k + " = " + v));
4}

1val callbackUrl = data?.getStringExtra(Payments.EXTRA_CALLBACK_URL) ?: return
2
3if (sabpaisa.payments.verifyReturnUrl(callbackUrl)) {
4    // Signature valid — parse query params for status, merchantTxnId, etc.
5    val uri = Uri.parse(callbackUrl)
6    val status = uri.getQueryParameter("status") // "SUCCESS" or "FAILED"
7} else {
8    // Signature invalid — reject
9}

1String callbackUrl = data.getStringExtra(Payments.EXTRA_CALLBACK_URL);
2
3if (sabpaisa.verifyReturnUrl(callbackUrl)) {
4    // Signature valid — parse query params
5    Uri uri = Uri.parse(callbackUrl);
6    String status = uri.getQueryParameter("status");
7} else {
8    // Signature invalid — reject
9}

1viewModelScope.launch {
2    val enquiry = sabpaisa.transactions.enquiry(merchantTxnId = "ORDER-$orderId")
3    Log.d("SabPaisa", "Status: ${enquiry.data.status}")
4    Log.d("SabPaisa", "TxnId: ${enquiry.data.txnId}")
5    Log.d("SabPaisa", "Mode: ${enquiry.data.paymentMode}")
6    enquiry.data.udfData?.forEach { (k, v) -> Log.d("SabPaisa", "UDF $k = $v") }
7}

1sabpaisa.enquiry("ORDER-" + orderId)
2    .thenAccept(r -> runOnUiThread(() -> {
3        Log.d("SabPaisa", "Status: " + r.getData().getStatus());
4        Log.d("SabPaisa", "TxnId: "  + r.getData().getTxnId());
5        Log.d("SabPaisa", "Mode: "   + r.getData().getPaymentMode());
6        if (r.getData().getUdfData() != null) {
7            r.getData().getUdfData().forEach((k, v) -> Log.d("SabPaisa", "UDF " + k + " = " + v));
8        }
9    }))
10    .exceptionally(e -> { handleError(e.getCause()); return null; });

1import `in`.sabpaisa.pg.exceptions.*
2
3viewModelScope.launch {
4    try {
5        val response = sabpaisa.payments.createSession(params)
6    } catch (e: ValidationException) {
7        Log.e("SabPaisa", "Invalid ${e.field}: ${e.message}")
8    } catch (e: ApiException) {
9        Log.e("SabPaisa", "API error ${e.code}: ${e.message} (HTTP ${e.statusCode})")
10        if (e.retryable) { /* safe to retry — 429 or 5xx */ }
11    } catch (e: ChecksumException) {
12        Log.e("SabPaisa", "Checksum failed: ${e.message}")
13    } catch (e: SabPaisaException) {
14        Log.e("SabPaisa", "SDK error [${e.code}]: ${e.message}")
15    }
16}

1import in.sabpaisa.pg.exceptions.*;
2
3private void handleError(Throwable cause) {
4    if (cause instanceof ValidationException) {
5        ValidationException e = (ValidationException) cause;
6        Log.e("SabPaisa", "Invalid " + e.getField() + ": " + e.getMessage());
7    } else if (cause instanceof ApiException) {
8        ApiException e = (ApiException) cause;
9        Log.e("SabPaisa", "API error [" + e.getCode() + "] HTTP "
10            + e.getStatusCode() + ": " + e.getMessage());
11        if (e.isRetryable()) { /* safe to retry — 429 or 5xx */ }
12    } else if (cause instanceof ChecksumException) {
13        Log.e("SabPaisa", "Checksum failed: " + cause.getMessage());
14    } else if (cause instanceof SabPaisaException) {
15        SabPaisaException e = (SabPaisaException) cause;
16        Log.e("SabPaisa", "SDK error [" + e.getCode() + "]: " + e.getMessage());
17    }
18}
19
20// Usage:
21sabpaisa.createSession(params)
22    .thenAccept(response -> { /* ... */ })
23    .exceptionally(e -> { handleError(e.getCause()); return null; });