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

Element	Type	Example Value	Description
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

Element	Type	Example Value	Description
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