Topremit
OPEN APITopremit
OPEN APITopremit
  1. Virtual Account
  • Open API
    • Virtual Account
      • Create Virtual Account
        POST
      • Inquiry Status Virtual Account
        POST
      • Virtual Account Callback
        POST
      • Cancel Virtual Account
        POST
      • Simulate Virtual Account Payment (Test Mode Only)
        POST
    • QRIS
      • Create QRIS
      • Inquiry QRIS
      • QRIS Callback
      • Simulate QRIS Payment (Test Mode Only)
    • Fetch Access Token
      POST
  1. Virtual Account

Virtual Account Callback

Developing
POST
Last modified:2025-05-23 02:42:50
This API is used for real-time integration. Once payment is received, your system can automatically update the order status without calling the API.
Receive a POST callback notification from the gateway when a payment to a virtual account has been successfully made by the customer.
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://staging-uno.topremit.com' \
--header 'Authorization;' \
--header 'CHANNEL-ID;' \
--header 'X-TIMESTAMP;' \
--header 'X-SIGNATURE;' \
--header 'X-PARTNER-ID;' \
--header 'X-EXTERNAL-ID;' \
--header 'Content-type:  application/json' \
--data-raw '{
    "responseCode": "string",
    "responseMessage": "string",
    "virtualAccountData": {
        "partnerServiceId": "string",
        "customerNo": "string",
        "virtualAccountNo": "string",
        "trxId": "string",
        "additionalInfo": {},
        "paymentId": "string",
        "channelCode": "string",
        "status": "string",
        "created_at": "string"
    }
}'
Response Response Example
{}

Request

Header Params
Content-type
string 
required
Only accept application/json
Example:
application/json
Authorization
string 
required
Bearer token for authentication
CHANNEL-ID
string 
required
Unique identifier for the channel
X-TIMESTAMP
string 
required
Client's current local time in ISO 8601 format: yyyy-MM- ddTHH:mm:ssTZD.
e.g., 2025-05-15T12:34:31+07:00
X-SIGNATURE
string 
required
Format: HMAC_SHA512 (clientSecret, stringToSign) with stringToSign = HTTPMethod +":"+ EndpointUrl +":"+ AccessToken +":"+ Lowercase(HexEncode(SHA256(minify(RequestBody))))+ ":" + X-TimeStamp
X-PARTNER-ID
string 
required
Your assigned Client ID
X-EXTERNAL-ID
string 
required
Unique idempotency key for the request (valid for at least 24 hours)
Body Params application/json
partnerServiceId
string 
required
Identifier for the partner service
customerNo
string 
required
Customer number associated with the VA
virtualAccountNo
string 
required
Desired Virtual Account number.
You may assign a specific Virtual Account number using this parameter. If omitted, the system will automatically generate one. Ensure the number you provide is within your allocated VA range and do not include the merchant code prefix, as it will be added automatically.
virtualAccountName
string 
required
trxId
string 
required
Unique transaction ID provided by the merchant. Please note that this field needs to be unique for each Virtual Account.
paidAmount
object 
required
value
string 
required
currency
string 
required
trxDateTime
string 
required
referenceNo
string 
required
Payment Id generated by system
additionalInfo
object 
required
paymentId
string 
required
Payment Id Generated by System
status
string 
required
paidAt
string 
required
createdAt
string 
required
type
string 
required
Always pass VIRTUAL_ACCOUNT for Virtual account callback
Examples

Responses

🟢200Success
application/json
Body
object {0}
Previous
Inquiry Status Virtual Account
Next
Cancel Virtual Account
Built with