07-TX Verification Failed
- Post-Transaction Approval - Transaction Verification Failed.
- GTR will send a callback request (
callbackType=9) with an incorrect transaction ID that should NOT be found in your system. - Your server should return a failed verification response with the appropriate error code.
GTR Request (GTR → VASP)
- Method:
POST - Your Callback Endpoint:
https://[YOUR_CALLBACK_URL] - Authentication:
- mTLS (Mutual Transport Layer Security) - GTR will authenticate using client certificates
- Header:
Content-Type: application/json
- Body:
{
"requestId": "test-[RANDOM_ID]",
"invokeVaspCode": "[YOUR_VASP_CODE]",
"originatorVasp": "[TESTER_VASP_CODE]",
"beneficiaryVasp": "[YOUR_VASP_CODE]",
"callbackType": 9,
"callbackData": {
"requestId": "test-[RANDOM_ID]",
"ticker": "--YOU SHOULD NOT REFER TO THIS TICKER--",
"address": "[TEST_ADDRESS]",
"tag": "[ADDRESS_TAG]",
"txId": "[TX_ID]-should-be-incorrect-tx-id",
"network": "[NETWORK_SYMBOL]",
"initiatorVasp": "[TESTER_VASP_CODE]"
}
}
curl -v --location --request POST 'https://[YOUR_CALLBACK_URL]' \
-k \
--header 'Content-Type: application/json' \
--data-raw '{
"requestId": "test-abc123def456",
"invokeVaspCode": "[YOUR_VASP_CODE]",
"originatorVasp": "[TESTER_VASP_CODE]",
"beneficiaryVasp": "[YOUR_VASP_CODE]",
"callbackType": 9,
"callbackData": {
"requestId": "test-abc123def456",
"ticker": "--YOU SHOULD NOT REFER TO THIS TICKER--",
"address": "[TEST_ADDRESS]",
"tag": "[ADDRESS_TAG]",
"txId": "[TX_ID]-should-be-incorrect-tx-id",
"network": "[NETWORK_SYMBOL]",
"initiatorVasp": "[TESTER_VASP_CODE]"
}
}'
Hint:
callbackType: 9indicates transaction verification for Post-Transaction- The transaction ID in this test is intentionally incorrect and should NOT be found
- Do NOT use the
tickerfield to search for users - Your server should respond within 30 seconds
Materials:
- Receiver Callback API 2: TX Verification
- Authentication & mTLS Setup
- Callback Server Setup Guide
- Python Callback Server Example
- Golang Callback Server Example
- List of Networks
- Post-Transaction Travel Rule Overview
Expected Response (VASP → GTR)
When the transaction ID is not found in your system, you should return:
- HTTP Status Code: 200
verifyStatus: 200007 (TXID Not Found)
{
"verifyStatus": 200007,
"verifyMessage": "TX ID Not Found"
}
Test Validation
Success Criteria:
- ✅ Your callback server responds within 30 seconds
- ✅ HTTP status code 200 returned
- ✅
verifyStatus: 200007indicates "TXID Not Found" - ✅ Proper error handling for non-existent transaction IDs
Common Issues:
- ⚠️ Wrong Error Code: Must return
verifyStatus: 200007for TXID not found - ⚠️ HTTP Status Confusion: Return HTTP 200 even for verification failures
- ⚠️ Ticker Reference: Do NOT use the ticker field to search for users