Skip to main content
Search

Callback - Address Verification

When your counterparty initiated a Pre-transaction Travel Rule request and they designate your VASP as the Travel Rule Receiver VASP, you will receive this callback to verify the address belongs to your VASP or not with callbackType=6

For further details of the request structure, see: RegularizeCallbackVerifyAddressRequest.

  • Travel Rule Type: Pre-transaction Travel Rule
  • Your Role:
    • Travel Rule Receiver VASP
    • Beneficiary VASP
  • Your Counterparty:
    • Travel Rule Initiator VASP
    • Originator VASP
  • Your Responsibility: Confirm address ownership
  • Callback Type: 6

Request & Response​

You can expect to receive below request From GTR:

{
  "requestId": "FdXI1VL3CepU",
  "invokeVaspCode": "[Invoker VASP Code]",
  "originatorVasp": "[Originator VASP Code]",
  "beneficiaryVasp": "[Beneficiary VASP Code]",
  "callbackType": 6,
  "callbackData": {
    "requestId": "FdXI1VL3CepU",
    "originatorVasp": "[Originator VASP Code]",
    "originatorVaspName": "[Originator VASP Name]",
    "ticker": "ETC",
    "address": "0x41ebF291D8BFb6481B4Ab1E26c412A96484b1454",
    "tag": "",
    "network": "Sepolia",
    "initiatorVasp": "[Initiator VASP Code]"
  }
}
  • Once you receive this callback request, you can directly search the user wallet address by address and tag and network.
  • the tag should be pre-processed so that if tag="" or tag=null, it should be treated as None or remove from the search query conditions,
  • the address is exact search. Don't use LIKE '%{address}%' or fuzzy to search, it must be equal = '{address}'.

For different situations, GTR expects your response as below. GTR will treat this callback request as Timeout if no response from your server in 2 seconds.

Response A: Address exists​

{
  "verifyMessage": "success",
  "verifyStatus": 100000
}

Response B: Address not exists​

{
  "verifyMessage": "address not found",
  "verifyStatus": 200001
}

Response C: Multiple addresses found​

This could happen if some networks (e.g: XLM, TRX, TON) required tag but you didn't receive it in the request.

{
  "verifyMessage": "Too many addresses",
  "verifyStatus": 200001
}