iOS SDK

1dependencies: [
2    .package(
3        url: "https://bitbucket.org/sabpaisa-wp-29/ios-plugin-2.0.git",
4        from: "1.0.0"
5    )
6]

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

1// Parse query parameters from the callback URL (keys are snake_case)
2let params = ReturnUrlParams(
3    transactionId: queryParams["transaction_id"] ?? "",
4    merchantTxnId: queryParams["merchant_txn_id"] ?? "",
5    status:        queryParams["status"] ?? "",
6    amount:        queryParams["amount"] ?? "",
7    paidAmount:    queryParams["paid_amount"] ?? "",
8    paymentMode:   queryParams["payment_mode"] ?? "",
9    timestamp:     queryParams["timestamp"] ?? "",
10    signature:     queryParams["signature"] ?? ""
11)
12
13if sabpaisa.payments.verifyReturnUrl(params) {
14    // Signature valid — check params.status for "SUCCESS" / "FAILED"
15    print("Payment status: \(params.status)")
16} else {
17    // Signature invalid — do not trust the result
18}

1// expects snake_case keys
2let params = ReturnUrlParams.fromJson(queryParamsDictionary)

1let enquiry = try await sabpaisa.transactions.enquiry(
2    merchantTxnId: "ORDER-123"
3)
4
5print(enquiry.data.status)      // "SUCCESS", "FAILED", "PENDING"
6print(enquiry.data.txnId)       // SabPaisa transaction ID
7print(enquiry.data.paymentMode) // "UPI", "CARD", "NET_BANKING", etc.
8print(enquiry.data.udfData)     // User-defined fields (Dictionary)

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

1let enquiry = try await sabpaisa.transactions.enquiry(
2    merchantTxnId: "ORDER-456"
3)
4
5if let udfData = enquiry.data.udfData {
6    for (key, value) in udfData {
7        print("\(key): \(value)")
8    }
9}

1do {
2    let response = try await sabpaisa.payments.createSession(request)
3} catch let error as SabPaisaError {
4    switch error {
5    case .validationError(let field, let message):
6        print("Invalid \(field): \(message)")
7    case .apiError(let details):
8        print("API error \(details.code): \(details.message) (HTTP \(details.statusCode))")
9        if details.retryable {
10            // Safe to retry (429 or 5xx)
11        }
12    case .checksumError(let message):
13        print("Checksum failed: \(message)")
14    case .configError(let message):
15        print("Config error: \(message)")
16    case .sdkError(let message, let code):
17        print("SDK error [\(code)]: \(message)")
18    }
19}