This document describes how to process the basic-card-v1
payment container type when you integrate with Meta Pay. The payment instrument delivered in this container is an encrypted credit card.
For more general information, see Overview of Meta Pay Integration. See Payment processing for information common to all container types.
The information below is intended for payment partners.
Container data for a basic-card-v1
container has the following properties.
Property | Type | Description | Required |
---|---|---|---|
| The container type. | Yes | |
| String | An opaque ID that uniquely identifies the context that the container is intended for. Verify the container context to prevent misuse of containers. | Yes |
| String | The unique identifier for the merchant. | Yes |
| Integer | The unix time in milliseconds. | Yes |
| Object | The data for a payment card. | Yes |
| String | The name on the payment card. | Yes |
| String | The payment card number. | Yes |
| String | The month the payment card expires. Valid values are | Yes |
| String | The year the payment card expires. Specify the year with 4 digits. | Yes |
| Object | The billing address for the payment card. | Yes |
| String | The street address for the billing address. | No |
| String | A second line for the billing address. | No |
| String | The city for the billing address. | No |
| String | The state for the billing address. | No |
| String | The postal code for the billing address. | Yes |
| String | The Alpha-2 code from the ISO 3166-1 standard for the billing address. | Yes |
The following is an example of container data for a basic-card-v1
container:
{ container_type: 'basic-card-v1', container_context: '76077dca-8c57-4536-bf48-30bd3f02196e', merchant_id: '123e4567-e89b-12d3-a456-426614174000', created_time: 1582230020020, card_data: { account_holder_name: '<name>', card_number: '4111111111111111', expiry_month: '01', expiry_year: '2020', billing_address: { street1: '1 Hacker Way', street2: 'Suite #111', city: 'Menlo Park', state: 'CA', postal_code: '94025', country: 'US' } } }