Basic Card Processing in Meta Pay

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

Container data for a basic-card-v1 container has the following properties.

Property	Type	Description	Required
`container_type`	FBPayContainerType	The container type.	Yes
`container_context`	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
`merchant_id`	String	The unique identifier for the merchant.	Yes
`created_time`	Integer	The unix time in milliseconds.	Yes
`card_data`	Object	The data for a payment card.	Yes
`card_data.account_holder_name`	String	The name on the payment card.	Yes
`card_data.card_number`	String	The payment card number.	Yes
`card_data.expiry_month`	String	The month the payment card expires. Valid values are `'01'` to `'12'`.	Yes
`card_data.expiry_year`	String	The year the payment card expires. Specify the year with 4 digits.	Yes
`card_data.billing_address`	Object	The billing address for the payment card.	Yes
`billing_address.street1`	String	The street address for the billing address.	No
`billing_address.street2`	String	A second line for the billing address.	No
`billing_address.city`	String	The city for the billing address.	No
`billing_address.state`	String	The state for the billing address.	No
`billing_address.postal_code`	String	The postal code for the billing address.	Yes
`billing_address.country`	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'
    }
  }
}