SinglePaymentStatus
GET
https://test.api.neotek.sa/b2b-unified/v1/payments/single/status/{transactionId}Sandbox URL · in Production call https://api.neotek.sa
Where one payment has got to, by the transaction id you got back when you initiated it.
Path parameters:
| Parameter | Required | Description |
|---|---|---|
transactionId | Required | the transactionId from the SinglePayment response |
Query parameters:
| Parameter | Required | Description |
|---|---|---|
bankCode | Required | which bank executed the payment: RJHISARI or ARNBSARI |
Headers:
| Parameter | Required | Description |
|---|---|---|
authorization | Required | Bearer <ACCESS_TOKEN> |
cURL
curl -X GET 'https://test.api.neotek.sa/b2b-unified/v1/payments/single/status/{transactionId}' \ --header 'authorization: Bearer <ACCESS_TOKEN>' \ --url-query 'bankCode=ARNBSARI'Response — paymentStatus is PAYMENT_STATUS_ACCEPTED, PAYMENT_STATUS_COMPLETED or PAYMENT_STATUS_FAILED
JSON
{ "success": true, "code": "SUCCESS", "message": "Payment status retrieved successfully", "transactionId": "OB20260115123456", "paymentStatus": "PAYMENT_STATUS_COMPLETED", "statusDescription": "Payment processed successfully"}Errors — each failure carries an error category and a specific code
| Status | Codes | Typical cause |
|---|---|---|
400 ERROR_CATEGORY_VALIDATION_FAILED | INVALID_IBAN, INVALID_AMOUNT, INVALID_ACCOUNT, INVALID_CURRENCY, INVALID_BANK_CODE, INVALID_REFERENCE, ACCOUNT_NOT_FOUND, BENEFICIARY_NOT_FOUND | Bad or missing field — wrong IBAN format, unknown bankCode, reference over 16 characters |
401 ERROR_CATEGORY_AUTH_FAILED | AUTH_FAILED, CREDENTIALS_NOT_FOUND, UNAUTHORIZED | Token missing or expired, or no vault credentials for your app with that bank |
404 ERROR_CATEGORY_NOT_FOUND | NOT_FOUND | Resource not found |
409 ERROR_CATEGORY_DUPLICATE | DUPLICATE_TRANSACTION, DUPLICATE_REFERENCE, DUPLICATE_PAYMENT | You reused a transactionReference |
422 ERROR_CATEGORY_BANK_REJECTED | INSUFFICIENT_FUNDS, AMOUNT_LIMIT_EXCEEDED, DAILY_LIMIT_EXCEEDED, INVALID_PAYMENT_DATE, ACCOUNT_BLOCKED, ACCOUNT_CLOSED, PAYMENT_NOT_ALLOWED | The request was valid; the bank declined it |
500 ERROR_CATEGORY_SYSTEM_FAILURE | SYSTEM_ERROR, INTERNAL_ERROR | Gateway-side failure |
503 ERROR_CATEGORY_TEMPORARY_FAILURE | SERVICE_UNAVAILABLE, BANK_UNAVAILABLE, NETWORK_ERROR, NETWORK_TIMEOUT, CONNECTION_REFUSED, REQUEST_TIMEOUT | Transient — retry with backoff |