gcm/recipient-contacts/add

post

https://earthnode-dev.vopay.com/api/v2/gcm/recipient-contacts/add

Add a recipient contact. All name, address, and phone fields must comply with Mastercard Cross-Border Services Data Quality Standards (effective April 20, 2026).

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Form Data

AccountID

string

required

Your account ID

Key

string

required

API key for the account

Signature

string

required

Hashed signature for the request

EmailAddress

string

required

The email address of the recipient contact

ContactClientType

string

required

If the contact is an individual or business

ClientAccountID

string

The client account ID the recipient belongs to

RecipientContactID

string

The ID for the recipient contact

BusinessName

string

Full legal business name of the recipient. Required if FirstName and LastName are not provided. Must be 2-60 characters and contain at least one letter. No abbreviations except standard suffixes (e.g. LLC, Ltd.).

FirstName

string

First name of the individual recipient. Required if BusinessName is not provided. Must be 2-60 characters using only letters, spaces, commas, apostrophes, hyphens, and dots. No initials, acronyms, or company identifiers.

LastName

string

Last name of the individual recipient. Required if BusinessName is not provided. Must be 2-60 characters using only letters, spaces, commas, apostrophes, hyphens, and dots. No initials, acronyms, or company identifiers.

PhoneNumber

string

required

Phone number of the recipient. Digits only, 9-15 characters. No spaces or hyphens (e.g. 19998887777).

Address1

string

required

Street address of the recipient. Must include a street name (e.g. 20 Longleat Drive). Numbers only are not accepted.

Address2

string

The second address line of the recipient contact

City

string

required

City of the recipient's address.

Province

string

The province of the address

PostalCode

string

The postal code of the address

Country

string

Country of the recipient's address. Accepts full country name or ISO 3166-1 alpha-2 or alpha-3 code. Sanctioned countries are not accepted.

DateOfBirth

string

Date of birth of the recipient in YYYY-MM-DD format (e.g. 1990-01-31).

Nationality

string

The nationality specified using full country name or ISO 3166-1 alpha-2 or ISO 3166-1 alpha-3 code.

Language

string

The language preference

SourceOfIncome

string

The source of income of the recipient contact

Occupation

string

The occupation of the recipient contact

RelationshipWithBeneficiary

string

The sender's relationship to the recipient contact

Response

200