Skip to main content

Transfer Status

POST/v1.0/emoney/otc-status.htm

This API is used to inquiry status cashout

API Type
SNAP API
Expected Timeout
8 second
SNAP Service Code
45
Accept
application/json
Content Type
application/json
Content-type
string
1 - 127 charactersRequired
Content type, value always application/json
Authorization
string
1 - 2048 charactersConditional
Contains bearer JWT token, which has been obtained from Authorization Token Request API
Conditional Info
Y:= Signature option is symmetric approach
X-TIMESTAMP
string
25 charactersRequired
Transaction date time, in format YYYY-MM-DDTHH:mm:ss+07:00. Time must be in GMT+7 (Jakarta time)
X-SIGNATURE
string
Required
Signature need to be generated with symmetricSignature or asymmetricSignature method
ORIGIN
string
Origin domain
X-PARTNER-ID
string
1 - 36 charactersRequired
Unique identifier for partner was generated by DANA, or known as clientId
X-EXTERNAL-ID
string
1 - 36 charactersRequired
Unique messaging reference identifier generated by merchant and should be unique within the same day
CHANNEL-ID
string
1 - 5 charactersRequired
Device identification on which the API services is currently being accessed by the end user (customer)
originalPartnerReferenceNo
string
1 - 64 charactersRequired
Original transaction identifier on partner system
originalReferenceNo
string
1 - 64 characters
Original transaction identifier on DANA system
originalExternalId
string
1 - 36 characters
Original external identifier on header message
serviceCode
string
2 charactersRequired
Transaction type indicator is based on the service code of the original transaction request, value always 44
customerNumber
string
1 - 32 charactersRequired
Customer account number
transactionDate
string
25 characters
Transaction date, in format YYYY-MM-DDTHH:mm:ss+07:00. Time must be in GMT+7 (Jakarta time)
amount
money
Required
Amount. Contains two sub-fields:
1. Value: Transaction amount, including the cents
2. Currency: Currency code based on ISO
value
string
1 - 19 charactersRequired
Value of amount. Following ISO-4217, for IDR the value includes 2 decimal digits separated with point e.g.,IDR 10.000,- will be placed with 10000.00
currency
string
1 - 3 charactersRequired
Currency
additionalInfo
json object
Additional information
POST .../v1.0/emoney/otc-status.htm HTTP/1.2
Content-type: application/json
Authorization: Bearer gp9HjjEj813Y9JGoqwOeOPWbnt4CUpvIJbU1mMU4a11MNDZ7Sg5u9a
X-TIMESTAMP: 2021-12-03T10:37:11+07:00
X-SIGNATURE: 85be817c55b2c135157c7e89f52499bf0c25ad6eeebe04a986e8c862561b19a5
ORIGIN: www.hostname.com
X-PARTNER-ID: 82150823919040624621823174737537
X-EXTERNAL-ID: 41807553358950093184162180797837
CHANNEL-ID: 95221
{
  "originalPartnerReferenceNo": "14054Q0727520211128121824995",
  "originalReferenceNo": "2021112810121482030100166514528830697",
  "originalExternalId": "30443786930722726463280097920912",
  "serviceCode": "44",
  "customerNumber": "081234567890",
  "transactionDate": "2021-12-03T10:37:11+07:00",
  "amount": {
    "currency": "IDR",
    "value": "50000.00"
  },
  "additionalInfo": {
  }
}
Content-type
string
1 - 127 charactersRequired
Content type, value always application/json
X-TIMESTAMP
string
25 charactersRequired
Transaction date time, in format YYYY-MM-DDTHH:mm:ss+07:00. Time must be in GMT+7 (Jakarta time)
responseCode
string
7 charactersRequired
Refer to response code list
responseMessage
string
1 - 150 charactersRequired
Refer to response code list
originalReferenceNo
string
1 - 64 charactersConditional
Original transaction identifier on DANA system
Conditional Info
Y:= Successfully processed
originalPartnerReferenceNo
string
1 - 64 characters
Original transaction identifier on partner system
originalExternalId
string
1 - 36 characters
Original external identifier on header message
serviceCode
string
2 charactersRequired
Transaction type indicator (service code of the original transaction request)
latestTransactionStatus
string
2 charactersRequired
Status of latest transaction:
• 00 = Success
• 01 = Initiated
• 05 = Canceled
• 06 = Failed
• 07 = Not found
transactionStatusDesc
string
1 - 50 characters
Description of transaction status
transactionDate
string
25 characters
Transaction date, in format YYYY-MM-DDTHH:mm:ss+07:00. Time must be in GMT+7 (Jakarta time)
amount
money
Amount. Contains two sub-fields:
1. Value: Transaction amount, including the cents
2. Currency: Currency code based on ISO
value
string
1 - 19 charactersRequired
Value of amount. Following ISO-4217, for IDR the value includes 2 decimal digits separated with point e.g.,IDR 10.000,- will be placed with 10000.00
currency
string
1 - 3 charactersRequired
Currency
additionalInfo
json object
Additional information
Content-type: application/json
X-TIMESTAMP: 2021-12-03T10:37:12+07:00
{
  "responseCode": "2004500",
  "responseMessage": "Successful",
  "originalReferenceNo": "2021112810121482030100166514528830697",
  "originalPartnerReferenceNo": "14054Q0727520211128121824995",
  "originalExternalId": "30443786930722726463280097920912",
  "serviceCode": "00",
  "latestTransactionStatus": "00",
  "transactionStatusDesc": "Success",
  "transactionDate": "2021-12-03T10:20:12+07:00",
  "amount": {
    "currency": "IDR",
    "value": "50000.00",
  },
  "additionalInfo": {
  }
}
ResponseCauseSolution
2004500Successful
Success to be processed
Mark Transfer Status based on latestTransactionStatus:
00 - Order has been successfully paid, mark Cashout as Success
01 - Order waiting payment process, mark Cashout as Pending. Hold the money and retry periodically
05 - Order has been cancelled, mark Cashout as Failed
06 - Order payment failed, mark Cashout as Failed
07 - Order not found, mark Cashout as Failed
4004500Bad Request
General request failed error
Mark Transfer Status process as Failed and Cashout as Pending. Hold the money and retry request with proper parameter
4004501Invalid Field Format
Invalid format for certain field
Mark Transfer Status process as Failed and Cashout as Pending. Hold the money and retry request with proper parameter
4004502Invalid Mandatory Field
Missing or invalid format on mandatory field
Mark Transfer Status process as Failed and Cashout as Pending. Hold the money and retry request with proper parameter
4014500Unauthorized. [reason]
General unauthorized error
Mark Transfer Status process as Failed and Cashout as Pending. Hold the money and retry request with proper parameter
4014501Invalid Token (B2B)
Authorization token are invalid, perhaps due to token expiry for B2B
Mark Transfer Status process as Failed and Cashout as Pending. Hold the money and retry request with proper parameter
4044501Transaction Not Found
Transaction not found
Mark Transfer Status process as Failed and Cashout as Failed. Hold the money
4294500Too Many Requests
Maximum transaction limit exceeded
Mark Transfer Status process as Pending and Cashout as Pending. Hold the money and retry request periodically
5004500General Error
General error non retry-able
Mark Transfer Status process as Failed and Cashout as Pending. Hold the money and retry request periodically
5004501Internal Server Error
Unknown internal server failure, please retry the process again
Mark Transfer Status process as Pending and Cashout as Pending. Hold the money and retry request periodically
Total timeout
Total timeout, the client side does not get any responses from the server side (Can be due to network issue, server slowing down, and so on)
Do a retry maximum 3 attempts, if still fails mark Transfer Status process as Pending and Cashout as Pending. Hold the money
Unexpected response (Empty field/field does not exist/undefined response code)
The server does not produce expected responses (Can be due to hardware failure, bugs, and so on)
  • If the response code prefix are 202 and 5XX, mark Transfer Status process as Pending and Cashout as Pending. Hold the money
  • If empty field/field does not exist, mark Transfer Status process as Pending and Cashout as Pending. Hold the money
ask AIAI Assistant
Need help with our documentation?
Start from our frequently asked questions or feel free to ask anything else.

AI generated responses may contain mistakes.