06-TX Verification Success

• Post-Transaction Approval - Transaction Verification Success.
• GTR will send a callback request (callbackType=9) to verify if a specific transaction ID and beneficiary address belong to your system.
• Your server should confirm transaction ownership and return a successful verification response.

---

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]",
        "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]",
            "network": "[NETWORK_SYMBOL]",
            "initiatorVasp": "[TESTER_VASP_CODE]"
        }
    }'

Hint:

• callbackType: 9 indicates transaction verification for Post-Transaction
• Do NOT use the ticker field to search for users
• Both txId and address must be validated
• 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 is found in your system, you should return:

• HTTP Status Code: 200
• verifyStatus: 100000 (success)

{
    "verifyStatus": 100000,
    "verifyMessage": "Transaction verification passed"
}

---

Test Validation

Success Criteria:

• ✅ Your callback server responds within 30 seconds
• ✅ HTTP status code 200 returned
• ✅ verifyStatus: 100000 indicates successful verification
• ✅ Transaction ID and address lookup confirms ownership

Common Issues:

• ⚠️ Wrong Status Code: Return HTTP 200 even for failed verification (use verifyStatus instead)
• ⚠️ Ticker Reference: Do NOT use the ticker field to search for users
• ⚠️ Missing TXID: Both transaction ID and address must be validated