- Disbursement
- Response Code
Disbursement
Response Code
Complete reference of API response codes for Disbursement transactions.
Overview
This page provides a comprehensive list of all response codes returned by the Disbursement API. Each response code indicates the result of your API request and includes recommended merchant actions.
Response Codes
| Response Code | Response Message | Description | Merchant Action |
|---|---|---|---|
| SP000 | Successfully | Success | Need check inquiry status |
| SP001 | Transaction Failure | Failed Transaction | Need check inquiry status |
| SP002 | General Failure | Internal Server Error | Need check inquiry status |
| SP003 | Insufficient Balance | Running out of account balance | Need check inquiry status |
| SP004 | Duplicate Reference Number | Duplicate Reference Number | - |
| SP005 | Timeout | Gateway timeout | Need check inquiry status |
| SP006 | Exceed Beneficiary Limit | Beneficiary has exceeded the amount transaction limit | Need check inquiry status |
| SP007 | Exceed Account Limit | Your account reached transaction limit | Please contact IT Support *Rarely Occurred |
| SP008 | Invalid Reference Number | Reference Number does not exists | - |
| SP009 | Transaction Not Found | Transaction Not Found | - |
| SP010 | Beneficiary Account Not Found | Beneficiary Account Not Found | - |
| SP011 | Beneficiary Vendor Not Active | Beneficiary Vendor Not Active | - *Rarely Occurred |
| SP012 | Bad Request | Bad Request | - *Rarely Occurred |
| SP013 | Unauthorized | Unauthorized | - *Rarely Occurred |
| SP014 | Not Found | Not Found | - |
| SP015 | Forbidden | Forbidden | - *Rarely Occurred |
| SP016 | Signature Invalid | Signature Invalid | - *Rarely Occurred |
| SP017 | Unauthorized IP | Your IP Not Authorized | Please contact IT Support *Rarely Occurred |
| SP018 | Validation error | Payload request validation error | - |
| SP019 | General Error | General Error | Please contact IT Support *Rarely Occurred |
| SP020 | Merchant Account Not Found | Merchant Account Not Found | - |
Response Categories
Success Codes
- SP000 - Request processed successfully
Error Codes Requiring Status Check
These codes indicate the request may be pending or uncertain. Always check transaction status:
- SP001 - Transaction Failure
- SP002 - General Failure
- SP003 - Insufficient Balance
- SP005 - Timeout
- SP006 - Exceed Beneficiary Limit
Client Error Codes
These codes indicate issues with your request:
- SP004 - Duplicate Reference Number
- SP008 - Invalid Reference Number
- SP010 - Beneficiary Account Not Found
- SP011 - Beneficiary Vendor Not Active
- SP012 - Bad Request
- SP013 - Unauthorized
- SP014 - Not Found
- SP015 - Forbidden
- SP016 - Signature Invalid
- SP018 - Validation error
- SP020 - Merchant Account Not Found
System Error Codes
These codes require contacting support:
- SP007 - Exceed Account Limit
- SP017 - Unauthorized IP
- SP019 - General Error
Important Notes
- When receiving response codes that require “Need check inquiry status”, always use the Inquiry Status endpoint to confirm the final transaction result
- For codes requiring “Please contact IT Support”, reach out to SingaPay technical support for assistance
- Client error codes (SP004, SP008, SP010-SP016, SP018, SP020) typically require fixing your request parameters or configuration
- Always handle errors gracefully in your integration and provide meaningful feedback to end users