Tài liệu này đã được cập nhật.
Bản dịch sang Tiếng Việt chưa hoàn tất.
Cập nhật bằng tiếng Anh: 28 tháng 6, 2022
Đã cập nhật bằng Tiếng Việt: 7 tháng 3, 2022

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.

PropertyTypeDescriptionRequired

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'
    }
  }
}