Skip to content

Sender data for Card Payouts

Last updated: 13th January 2022

If you're sending a card payout on behalf of another person (a money transfer), or a business/government entity (a third-party funds disbursement), you must include the details of that person or entity in the processing.senderInformation object in your payout request. You can see example payout requests with sender data on our Card Payouts page.

The data you need to provide depends on the card scheme:

If you don't provide sender data when it's required, your transaction will be declined.

For more details about sender data requirements, please contact your implementation manager.


Visa

Sender data for Visa money transfers

Fund transfer type = AA, PP, FT

The following table outlines the fields which should be included in the processing.senderInformation object.

Field nameUK/EU domesticCross-borderNotes

reference

string
required

(if accountNumber not available)

required

(if accountNumber not available)

The merchant's unique customer ID.

Up to 16 alphanumeric characters.

accountNumber

string
required

(if available)

required

(if available)

Up to 19 characters.

firstName

string
required
required

The full name must be provided. This information will show on the cardholder's statement.

Up to 15 characters.

lastName

string
required
required

The full name must be provided. This information will show on the cardholder's statement.

Up to 15 characters.

address

string
required
required

Required under UK law.

Up to 35 characters.

city

string
required
required

Up to 25 characters.

state

string

n/a

required

Up to 3 characters.

country

string
required
required

(if applicable)

Up to 2 characters.

sourceOfFunds

string
conditional
conditional

Possible values:

  • Credit
  • Debit
  • Prepaid
  • DepositAccount
  • MobileMoneyAccount
  • Cash

sourceOfFunds is mandatory when the issuer country is South Africa, and recommended for all

Sender data for Visa third-party funds disbursements

Fund transfer type = FD

The following table outlines the fields which should be included in the processing.senderInformation object.

Field nameUK/EU domesticCross-borderNotes

reference

string
required
required

The merchant's unique customer ID.

Up to 16 alphanumeric characters.

accountNumber

string
optional
optional

Up to 19 characters.

firstName

string
required
required

Merchant or government entity name. This information will show on the cardholder's statement.

Up to 15 characters.

lastName

string
required
required

Merchant or government entity name. This information will show on the cardholder's statement.

Up to 15 characters.

address

string
required
required

Required under UK law.

Up to 35 characters.

city

string
recommended
required

Up to 25 characters.

state

string

n/a

required

(if applicable)

Up to 3 characters.

country

string
required
required

Up to 2 characters.

sourceOfFunds

string
conditional
conditional

Possible values:

  • Credit
  • Debit
  • Prepaid
  • DepositAccount
  • MobileMoneyAccount
  • Cash

sourceOfFunds is mandatory when the issuer country is South Africa, and recommended for all

Non-Visa products

Merchants are responsible for identifying the source of funds for non-Visa products and correctly populating the sourceOfFunds field.


Mastercard

Sender data for Mastercard money transfers

Fund transfer type = AA, PP, FT

The following table outlines the fields which should be included in the processing.senderInformation object.

Field nameUK/EU domesticCross-borderNotes

firstName

string
required
required

Legal first name of sender. Do not use processor or intermediary name. This information will show on the cardholder's statement.

Up to 15 characters. Alphanumeric characters only; no spaces.

lastName

string
required
required

Legal last name of sender. Do not use processor or intermediary name. This information will show on the cardholder's statement.

Up to 15 characters. Alphanumeric characters only; no spaces.

address

string
required
required

Up to 35 characters.

city

string
optional
optional

Up to 25 characters.

state

string
optional
optional

Up to 3 characters.

country

string
required
required

Two-letter ISO country code.

Up to 2 characters.

postalCode

string
required
required

Up to 10 characters.

accountNumber

string
required

(if reference not available)

required

(if reference not available)

Up to 19 characters.

reference

string
required

(if accountNumber not available)

required

(if accountNumber not available)

Up to 16 alphanumeric characters.

sourceOfFunds

string
required
required

Possible values:

  • Credit
  • Debit
  • Prepaid
  • DepositAccount
  • MobileMoneyAccount
  • Cash

Sender data for Mastercard third-party funds disbursements

Fund transfer type = FD

The following table outlines the fields which should be included in the processing.senderInformation object.

Field nameUK/EU domesticCross-borderNotes

firstName

string
required
required

Legal first name of sender. Do not use processor or intermediary name. This information will show on the cardholder's statement.

Up to 15 characters. Alphanumeric characters only; no spaces.

lastName

string
required
required

Legal last name of sender. Do not use processor or intermediary name. This information will show on the cardholder's statement.

Up to 15 characters. Alphanumeric characters only; no spaces.

address

string
required
required

Up to 35 characters.

city

string
required
required

Up to 25 characters.

state

string
optional
optional

Up to 3 characters.

country

string
required
required

Two-letter ISO country code.

Up to 2 characters.

postalCode

string
required
required

Up to 10 characters.

accountNumber

string
required

(if reference not available)

required

(if reference not available)

Up to 19 characters.

reference

string
required

(if accountNumber not available)

required

(if accountNumber not available)

Up to 16 alphanumeric characters.

sourceOfFunds

string
required
required

Possible values:

  • Credit
  • Debit
  • Prepaid
  • DepositAccount
  • MobileMoneyAccount
  • Cash

On this page