Common payment objects

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

Owner object

Owner object example

{
	"firstName": "Otis",
	"lastName": "Lin",
	"email": "[email protected]",
	"phoneNumber": "01314532211",
        "organization": "DR",
	"address": {
	  "line1": "东城区景山前街4号",
	  "city": "北京市",
	  "country": "CN",
	  "postalCode": "100009"
	}
}

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 may be required for certain payment types.

Address object

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

{
    "neighborhood": "Centro",
    "phoneticFirstName": "John",
    "phoneticLastName": "Doe",
		"division": "Development"
}

Field	Required/Optional	Description
neighborhood	Optional	The neighborhood of the Customer.
phoneticFirstName	Optional	The phonetic spelling of the Customer's first name.
phoneticLastName	Optional	The phonetic spelling of the Customer's last name.
division	Optional	The division applicable to the Customer.