Skip to main content
Search

Callback - Address/TXID Verification Result Notify

✍️ If your VASP doesn't support Travel Rule Pending Solution, you can skip this implementation guide.

This callback API notifies the Travel Rule Initiator VASP of the Address Verification result or TXID Verification result.

GTR will forward the verification result with callType=13 to your service once the Travel Rule Receiver VASP has completed the Address Verification or TXID Verification.

TypePre-transaction Travel RulePost-transaction Travel Rule
Your Role in Travel RuleTravel Rule Initiator VASPTravel Rule Initiator VASP
Your Counterparty in Travel RuleTravel Rule Receiver VASPTravel Rule Receiver VASP
Your Role in TransferOriginator VASPBeneficiary VASP
Your Counterparty Role in TransferBeneficiary VASPOriginator VASP
Your Counterparty's ResponsibilityConfirmed ownership of AddressConfirmed ownership of TXID

Request

Once your Travel Rule Receiver VASP responds with the Address / TXID Verification result, you shall receive this callback request with callType=13.

✍️If Address / TXID Verification result is a Pass, you can expect to receive PII Verification result callback once your counterparty completes PII Verification.

If no, you won't receive any PII Verification Result and you can treat this Travel Rule as Failed.

{
"callbackType": 13,
"invokeVaspCode": "0xQKGsNzOq2Er-xh6ReiL",
"originatorVasp": "0xQKGsNzOq2Er-xh6ReiL",
"requestId": "[REQUEST-ID]",
"beneficiaryVasp": "gdummy",
"callbackData": {
"beneficiaryAddress": {
"address": "0x7Fcd17CADf410Aa68125fc17a1F5aE9f8aaacE44",
"addressType": 0,
"tag": ""
},
"blockchainTransaction": {
"blockHash": "",
"blockId": "",
"network": "BTC",
"ticker": "USDT",
"txId": "ae95d3168512dd179b5bb510a80c6cde485fe66f8cd349c4949a4bd386e7f033",
"txIdType": 0,
"vin": "",
"vout": ""
},
"notifyResult": {
"verifyMessage": "Address Verification Success",
"verifyStatus": 100000
},
"travelruleInfo": {
"beneficiaryVaspCode": "gdummy",
"initiatorVaspCode": "0xQKGsNzOq2Er-xh6ReiL",
"invokeVaspCode": "gdummy",
"originatorVaspCode": "0xQKGsNzOq2Er-xh6ReiL",
"receiverVaspCode": "gdummy",
"requestId": "[REQUEST-ID]",
"verificationDirection": 2
}
}
}

💡 GTR Implementation Recommendations

  • Once you receive this callback, you can update your in-house Travel Rule records to the latest stage and status accordingly.
  • If travelruleInfo.verificationDirection=1, it means this request has just completed TXID Verification.
  • If travelruleInfo.verificationDirection=2, it means this request has just completed Address Verification.