Skip to main content
Search

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: 9 indicates transaction verification for Post-Transaction
  • The transaction ID in this test is intentionally incorrect and should NOT be found
  • Do NOT use the ticker field to search for users
  • Your server should respond within 30 seconds

Materials:


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: 200007 indicates "TXID Not Found"
  • ✅ Proper error handling for non-existent transaction IDs

Common Issues:

  • ⚠️ Wrong Error Code: Must return verifyStatus: 200007 for 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