Common payment objects

Learn about payment objects that are common to all payment methods.

Owner object

Owner object example
Owner object example
{
"lastName": "山田",
"firstName": "太郎",
"email": "test@digitalriver.com",
"phoneNumber": "000-000-0000",
"organization": "Digital River",
"address": {
"line1": "1-16-24 Minami-gyotoku",
"line2": "Ichikawa-shi",
"city": "Chiba",
"state": "Kyongsangnamdo",
"postalCode": "272-0138",
"country": "JP"
}
}

Field

Required/Optional

Description

firstName

Required

The Customer's first name as it appears on the payment instrument.

lastName

Required

The Customer's last name as it appears on the payment instrument.

phoneNumber

Required

The Customer's phone number.

email

Required

The Customer's email address.

address

Required

An Address object.

additionalAddressInfo

Optional

An Additional Address Information object.

Additional address fields that may be required for certain payment types.

Address object

Address object example
Address object example
{
"line1": "1-16-24 Minami-gyotoku",
"line2": "Ichikawa-shi",
"city": "Chiba",
"state": "Kyongsangnamdo",
"postalCode": "272-0138",
"country": "JP"
}

Field

Required/Optional

Description

line1

Required

Line 1 of the Customer's billing address.

line2

Required

Line 2 of the Customer's billing address.

city

Required

City of the Customer's billing address.

state

Required

State of the Customer's billing address.

postalCode

Required

Postal Code of the Customer's billing address.

country

Required

Country of the Customer's billing address.

Additional address information object

Additional Address Information object
Additional Address Information object
{
"neighborhood": "Centro"
}

Field

Required/Optional

Description

neighborhood

Optional

The neighborhood of the Customer.