Recursos para IA
Tokenizar pagamento Apple Pay

Este endpoint permite descriptografar os dados de pagamento Apple Pay recebidos, tokenizando as informações do cartão e devolvendo um "card_token" para processamento do pagamento com a Orders API. Em caso de sucesso, a requisição retornará uma resposta com status 200. Em seguida, utilize o card token retornado para criar o pagamento com a Orders API.

POST

https://api.mercadopago.com/platforms/pci/applepay/v1/tokenize
Request parameters
Header
Authorization
string

OBRIGATÓRIO

Access Token obtido através do painel de desenvolvedores. Obrigatório ser enviado em todas as requisições.
X-Product-ID
string

OBRIGATÓRIO

Identificador do produto.
X-Public-Key
string

OBRIGATÓRIO

Public Key (chave pública) da sua aplicação do Mercado Pago, utilizada no frontend. Use a Public Key de teste no ambiente de teste e a de produção em produção. Você pode obtê-la em Suas integrações > Detalhes da aplicaçã
X-Request-ID
string
Identificador da requisição para fins de rastreamento.
Body
payment_method
object

OBRIGATÓRIO

Informações do meio de pagamento.
transaction_identifier
string

OBRIGATÓRIO

Identificador único da transação gerado pela Apple para cada transação.
device
object
Informações do dispositivo para prevenção de fraudes.
Response parameters
id
string
Card token. Envie-o como payment_method.token ao criar o pagamento com a Orders API.
bin
string
Primeiros dígitos do cartão.
Erros

400Erro de requisição.

invalid_request

O corpo da requisição está mal formado ou falta um campo obrigatório. Verifique a estrutura JSON e os parâmetros obrigatórios.

invalid_parameter

Um dos parâmetros tem um valor ou formato inválido. Verifique os valores aceitos para cada campo.

401Erro de autenticação.

unauthorized

As credenciais enviadas são inválidas ou estão ausentes. Verifique se você está enviando credenciais válidas para o ambiente que está utilizando.

424Erro de dependência.

failed_dependency

Uma dependência externa necessária para concluir a operação falhou. Aguarde um momento e tente novamente.

500Erro do servidor.

internal_server_error

Ocorreu um erro interno no servidor. Aguarde um momento e tente novamente. Se o problema persistir, entre em contato com o Suporte informando o x-request-id.

502Erro de gateway.

bad_gateway

Foi recebida uma resposta inválida de um serviço superior. Aguarde um momento e tente novamente.

503Serviço no disponible.

service_unavailable

O serviço está temporariamente indisponível. Aguarde um momento e tente novamente.

Request
curl -X POST \
    'https://api.mercadopago.com/platforms/pci/applepay/v1/tokenize'\
    -H 'Content-Type: application/json' \
       -H 'Authorization: Bearer APP_USR-1*********685765-12*********1b4332e5c*********e077d7679*********664' \
       -H 'X-Product-ID: YOUR_PRODUCT_ID' \
       -H 'X-Public-Key: TEST-1234' \
       -H 'X-Request-ID: deb61aaa-ac8f-4404-9e9f-4466f7cb9c8d' \
       -H 'X-Test-Status: APRO' \
    -d '{
  "payment_method": {
    "type": "applepay",
    "payment_data": "PAYMENT_DATA_FROM_APPLE_BASE64"
  },
  "transaction_identifier": "test-applepay-transaction-12345",
  "device": {
    "fingerprint": {
      "os": "iOS",
      "system_version": "17.0",
      "model": "iPhone15,2",
      "resolution": "2532x1170",
      "ram": 4294967296,
      "disk_space": 128849018880,
      "free_disk_space": 107374182400
    },
    "meli": {
      "session_id": "session-123456789"
    }
  }
}'
Response
{
  "id": "5c055ff0d...00b888c85c64e",
  "bin": "44...49"
}