Query Tag

Returns whether the last 4 of a phone number match what is on record.
May also return the owner's name.

Venmo and PayPal paynames are confirmed through Visa+. Every other tag is confirmed through the Visa Alias Directory and needs type and directory: get both from Tag Inquiry.

Path Params
string
required

22-character ClientID. Ask TabaPay Support if you need to specify a SubClientID.

Body Params

Send value with type. The deprecated tagName is still accepted for paynames.

string
required

The network of the tag.
Supported Networks:

  • Visa
string

The tag to confirm, in the format of its type, with no control characters. A PAYNAME is +name.domain, with one ..

  • Venmo and PayPal paynames are confirmed through Visa+.
  • Every other tag is confirmed through the Visa Alias Directory. There it must be 3 to 320 characters (a phone number's leading + isn't counted), and directory is required.

Required with type. Use instead of tagName.

string
enum

The type of value:

  • PAYNAME Payname, +name.domain
  • EMAIL Email address
  • PHONE Phone number: digits, with or without a leading +
  • NATIVE_ALIAS The wallet's own handle, such as a Cash App $cashtag

Use the type that Tag Inquiry returns.

Required with value.

Allowed:
string
^[A-Za-z0-9._-]{1,36}$

The directory to confirm in: one of the directories that Tag Inquiry returns.

Required unless the tag is a Venmo or PayPal payname.

string
^[0-9]{4}$

Last 4 digits of the tag owner's phone number.

Optional. In the Visa Alias Directory, also send currency.

string
^[0-9]{3}$

Currency Number of the payment you're confirming for, such as 840 for USD.

Required with phoneLast4 in the Visa Alias Directory. Not used by Visa+.

string
^[A-Za-z0-9._-]{1,50}$

Your ID for the sender, which Visa uses for risk analysis. 1 to 50 letters, digits, ., _ or -. Don't send personal information such as a name, email address or phone number.

Optional. Visa Alias Directory only.

string
deprecated

Deprecated. Use value with type PAYNAME.

The name of the tag.

  • For Visa, this would be the payname

Always read as a payname, and read only when the request has no value with a type.

Responses

Language
Credentials
Bearer
JWT
URL
LoadingLoading…
Response
Choose an example:
application/json