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

QRIS Callback

Developing
POST
Last modified:2025-05-23 02:50:27
This API is used for real-time payment confirmation. Allows your system to automatically update order status once the QR code is paid.
Receive a POST webhook to your callback_url when a QRIS payment is successfully completed.
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
originalReferenceNo
string 
required
Payment Id Generated by System
originalPartnerReferenceNo
string 
optional
latestTransactionStatus
string 
required
transactionStatusDesc
string 
required
amount
object 
required
value
string 
required
currency
string 
required
additionalInfo
object 
required
paymentId
string 
required
Payment Id Generated by System
qrisInvoiceId
string 
required
createdAt
string 
required
Payment creation time
paidAt
string 
required
type
string 
required
Always pass QR for QR callback
Examples

Responses

🟢200Success
application/json
Body
object {0}
Previous
Inquiry QRIS
Next
Simulate QRIS Payment (Test Mode Only)
Built with