Wallet transaction Inquiry

• Endpoint: POST /v1.0/emoney/topup-status
• Tags: Indonesia SNAP/Disbursement

Description

This API is used for querying wallet payments. Please pay attention to the following matters when returning parameters of this interface, otherwise there may be a risk of capital loss:

When "responseCode":"2003900" and "responseMessage": "Success." and latestTransactionStatus is returned, it means the query is successful. Please refer to latestTransactionStatus for order status; When "responseCode":"4043901" and "responseMessage": "The order does not exist." and the query returns the same result after multiple queries at intervals (5 minutes), you can place an order again without changing partnerReferenceNo; In other scenarios, please check the parameters and re-query, and be careful to reset the X-TIMESTAMP;

Service Code=39

Parameters

Field	In	Type	Required	Constraints	Description
Content-Type	header	string	Yes		Media type of the resource, i.e. application/json.
X-TIMESTAMP	header	string	Yes		Request time, compliant with rfc3339 specification, format: yyyy-MM-dd'T'HH:mm:ss.SSSXXX The time must be within two minutes of the current time
X-SIGNATURE	header	string	Yes		Represents signature of a request.
CHANNEL-ID	header	string	Yes		Device identification on which the API services is currently being accessed by the end user , like APP，WAP，WEB.
Authorization	header	string	Yes		Represents access_token of a request; string starts with keyword “Bearer ” followed by access_token
X-PARTNER-ID	header	string	Yes		Merchant Id, the unique identifier generated when the merchant signs the contract with PayerMax
X-EXTERNAL-ID	header	string	Yes		Unique messaging reference identifier generated by the merchant.
sign	header	string	Yes		签名信息请参考技术文档

Parameter Examples

• Content-Type: ""
• X-TIMESTAMP: ""
• X-SIGNATURE: ""
• CHANNEL-ID: ""
• Authorization: ""
• X-PARTNER-ID: ""
• X-EXTERNAL-ID: ""
• sign: "FPFVT3o227JrFRbqu19boZCpVVTF9KznxyRawUmxpfXilHV/0yK46haPhAjNu1hPUMy7Vw/ILXhfzffNm4Fj0apWknlTY9OJxnSoQxS9BTFtc61tn5yV1q69x/kkBl82/qwg+XTJ4fOzy7Mar3VaC1E2PlDA6RkkKBUyNE6RYgsdB+Su7an4+4HVTNAnoe74WyvBgxTLMNg28igBTdqxaO3w/UBY6ObVp7vkqkQGdL1Y+HgmMYaAVwrM3+ALWGId0sJ+YqTY4WJ+0xCRGhaSnybiIjZsQEYyID68WNUfuavDLDsEhaMm/HfQvf5p0R1Ltovp3wwJnEbQcjY458iX5A=="

Request Body

Required

Content-Type: application/json

Field	Type	Required	Constraints	Description	Enum
originalPartnerReferenceNo	string	Yes	maxLength: 64	Merchant Order Id.

Example

{
  "originalPartnerReferenceNo": "20260812195820965100890"
}

Responses

200

Field	Type	Required	Constraints	Description	Enum
responseCode	string	Yes		Response code, following the SNAP standard.
responseMessage	string	Yes		Response description, following the SNAP standard.
originalPartnerReferenceNo	string	No	maxLength: 64	Merchant Order Id.
originalReferenceNo	string	No	maxLength: 64	PayerMax transaction serial Order Number.
transactionDate	string	No		Transaction creation time, conforming to rfc3339 specification, format: "yyyy-MM-dd'T'HH:mm:ss Z".
latestTransactionStatus	string	No	maxLength: 2	Transaction status: 00 - Success, 03 - Pending, 04 - Bounced Back, 06 - Failed.
amount	object	No
amount.value	string	Yes	maxLength: 12	The trade amount input by the merchant in the request.
amount.currency	string	Yes	maxLength: 3	The currency code of trade input by the merchant in the request.
additionalInfo	object	No
additionalInfo.destination	object	No		Payee Information (User).
additionalInfo.destination.amount	string	Yes	maxLength: 12	Payee - Amount to account.
additionalInfo.destination.currency	string	Yes	maxLength: 3	Payee - Receiving Currency.
additionalInfo.destination.exchangeRate	string	No		The exchange rate for converting the trade currency to the deduction currency.
additionalInfo.destination.fee	string	No	maxLength: 12	Payee - handling fee.
additionalInfo.destination.feeCurrency	string	No	maxLength: 3	Payee - handing fee currency.
additionalInfo.destination.tax	string	No	maxLength: 12	Payee - Tax fee.
additionalInfo.destination.taxCurrency	string	No	maxLength: 3	Payee - Tax fee currency.
additionalInfo.source	object	No		Disbursement Information (Merchant).
additionalInfo.source.amount	string	Yes	maxLength: 12	Payer - Deduction Amount.
additionalInfo.source.currency	string	Yes	maxLength: 3	Payer - Deduction Currency.
additionalInfo.source.exchangeRate	string	No		The exchange rate for converting the trade currency to the source currency.
additionalInfo.source.fee	string	No	maxLength: 12	Payer - handling fee.
additionalInfo.source.feeCurrency	string	No	maxLength: 3	Payer - handing fee currency.
additionalInfo.source.tax	string	No	maxLength: 12	Payer - Tax fee.
additionalInfo.source.taxCurrency	string	No	maxLength: 3	Payer - Tax fee Currency.
additionalInfo.payFinishTime	string	No		Transaction completion time, in line with rfc3339 specification, format: "yyyy-MM-dd'T'HH:mm:ss Z".
additionalInfo.fundsFreezeTime	string	No		Fund deduct time, conforms to rfc3339 specification, format: "yyyy-MM-dd'T'HH:mm:ss Z".
additionalInfo.fundsReturnTime	string	No		Fund return time, conforms to rfc3339 specification, format: "yyyy-MM-dd'T'HH:mm:ss Z".
additionalInfo.bounceBackTime	string	No		Order bounced back time, in line with rfc3339 specification, format: "yyyy-MM-dd'T'HH:mm:ss Z".
additionalInfo.additionalIdentifier	object	No		Additional transaction information, this field will be returned only after the withdrawal callback is upgraded to version 3.0 or above. If necessary, you can contact PayerMax technical support for adjustments.
additionalInfo.additionalIdentifier.referenceId	string	No		The transaction order number of the receiving bank/institution (based on historical experience, currently only the order number returned by BankTransfer in Saudi Arabia can be used as a voucher to confirm with the receiving bank whether the account has been received. The transaction order number format is such as: 20240418SAARNBARNB1B44410558522170)
additionalInfo.reference	string	No		A pass-through parameter, which will be returned the same in the notification callback API. This field is primarily to hold customized data from merchant.
additionalInfo.notifyEmail	string	No	maxLength: 64	Payee notification email address.
additionalInfo.originalResponseCode	string	No		Order result code, following the SNAP standard.
additionalInfo.originalResponseMessage	string	No		Order result code description, following the SNAP standard.

Response Example

{
  "amount": {
    "value": "10000.00",
    "currency": "IDR"
  },
  "originalReferenceNo": "20260812115824TD8357849403981200T08",
  "latestTransactionStatus": "06",
  "additionalInfo": {
    "payFinishTime": "2026-08-12T11:58:30 +0000",
    "destination": {
      "amount": "10000.00",
      "taxCurrency": "IDR",
      "exchangeRate": "1",
      "fee": "0.00",
      "feeCurrency": "IDR",
      "currency": "IDR",
      "tax": "0.00"
    },
    "originalResponseCode": "4033814",
    "originalResponseMessage": "Insufficient balance"
  },
  "originalPartnerReferenceNo": "20260812195820965100890",
  "responseMessage": "Success.",
  "transactionDate": "2026-08-12T11:58:24 +0000",
  "responseCode": "2003900"
}