Callback
An automated notification endpoint used to receive real-time updates from the payment system after a transaction has been processed.
1. Structure & Example Payload
The data structure sent via HTTP request to the merchant's callback endpoint. This payload contains comprehensive transaction information, including authentication headers and a body with detailed transaction data such as order number, payment status, fiat amounts, crypto amounts, and currency used.
The Header contains metadata for request authentication and verification, while the Body contains the actual transaction data that needs to be processed by the merchant's system to update order or transaction status in their database.
Header
accept
string
application/json
Specifies the response format expected from the server, typically application/json for API responses
content-type
string
application/json
Defines the format of data sent in the request body, typically application/json
signature
string
MIIEvgIBADANBgkqhkiG9w0BAQEFAASCBKgwggSkAgEAAoIBAQC9VJvL8Kg...
Using RSA-SHA256, use PUBLIC KEY to verify
Use this PUBLIC KEY to verify signature
-----BEGIN PUBLIC KEY-----
MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAxo527/Z330DV1rwgxSNk
J2B0sFmnwsMHyPEIHWr5b5CYdq5rGZCFClNmewO22PJX1fsfEOOm2n4UN5TTNHgq
5XOFhUCXO84jWKbuvkO0PQ8UYGly+yCvnGZcQVXpb1GTODNEtKZnVmrpXCEkjY2B
TTJcz2CRrwvrZtGkA8rjuRYGqvHxf/zARZdQuyzJfj92M5ZVah7zIWJxcPrVQ5VL
lhEckEO7K0payf1qZOgCHpeePRpe8sZF+/Yhbzq4rrVOhQQa7pz59PE0LWZyqcfv
RAhLP/5ZC/AFWu9fcNmJUjOGSFC9C0TvxzXycKtvVikUGigeAmsrP5KE1T3MSz1T
qQIDAQAB
-----END PUBLIC KEY-----Body
order_no
string
ORDER-198232324
Unique identifier for the order/transaction
status
string
Success
Current status of the transaction (Created, Success, Expired, Invalid, Failed)
amounts.fiat.base
string
100000
Base payment amount in fiat currency before fees
amounts.fiat.fee
string
20000
Processing fee amount in fiat currency
amounts.fiat.total
string
120000
Total payment amount including all fees in fiat currency
amounts.fiat.mdr_fee
string
5000
Merchant Discount Rate fee in fiat currency
amounts.fiat.merchant_received
string
95000
Final amount received by merchant in fiat currency after all deductions
amounts.crypto.base
string
6.092323
Base cryptocurrency amount before fees
amounts.crypto.fee
string
1.120434
Processing fee amount in cryptocurrency
amounts.crypto.total
string
7.212757
Total cryptocurrency amount including all fees
amounts.crypto.mdr_fee
string
0.334121
Merchant Discount Rate fee in cryptocurrency
amounts.crypto.merchant_received
strin
5.758202
Final cryptocurrency amount received by merchant after all deductions
currency
string
IDR
Currency code used (IDR for Indonesian Rupiah)
token.name
string
USDT
Name of the cryptocurrency token used (e.g., USDT, BTC, ETH)
token.network
string
BINANCE
Blockchain network where the token transaction occurred (e.g., BINANCE, ETHEREUM)
transaction_hash
string
0x771d70ee046da88aa0dbe6ed1f51b2180b01774f14cffc4c2ee1994135c0d50d
Blockchain transaction hash
timestamp
string
2025-02-15T14:30:25.123Z
Unix timestamp when the transaction was processed
metadata.source
string
neropay
Source system identifier (e.g., 'neropay')
metadata.version
string
2.0.0
API version used for the webhook
Last updated