Recursos para IA
Criar sessão do Apple Pay

Este endpoint permite criar uma nova sessão de pagamento Apple Pay e processá-lo pelo gateway da Apple. Em caso de sucesso, a requisição retornará uma resposta com status 201.

POST

https://api.mercadopago.com/applepay/v1/session
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çã
Body
id
string

OBRIGATÓRIO

Certificate ID do certificado tipo merchant. Esse valor é retornado na resposta à requisição /certificates/csr/generate.
merchantIdentifier
string

OBRIGATÓRIO

Merchant ID configurado no Portal Apple Developer.
domainName
string

OBRIGATÓRIO

Nome de domínio onde a sessão de pagamento será usada. Deve coincidir com o domínio verificado no Portal Apple Developer.
displayName
string

OBRIGATÓRIO

Nome da sua loja ou comércio exibido ao comprador no fluxo de pagamento do Apple Pay.
Response parameters
epochTimestamp
integer
Data e hora de criação da sessão, como timestamp Unix em milissegundos (milissegundos decorridos desde 1º de janeiro de 1970 UTC).
expiresAt
integer
Data e hora de expiração da sessão, como timestamp Unix em milissegundos (milissegundos decorridos desde 1º de janeiro de 1970 UTC).
merchantSessionIdentifier
string
Identificador da sessão do Apple Pay. Envie-o ao seu frontend para concluir o fluxo de pagamento com a Apple.
nonce
string
Valor aleatório usado para fins de segurança.
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.

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.

Request
curl -X POST \
    'https://api.mercadopago.com/applepay/v1/session'\
    -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: APP_USR-xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx' \
    -d '{
  "id": "CERTIFICATE_ID_MERCHANT",
  "merchantIdentifier": "merchant.your-identifier",
  "domainName": "your-domain.com",
  "displayName": "My store",
  "initiative": "web",
  "initiativeContext": "your-domain.com",
  "validationURL": "https://apple-pay-gateway.apple.com/paymentservices/startSession"
}'
Response
{
  "epochTimestamp": 1768253984908,
  "expiresAt": 1768257584908,
  "merchantSessionIdentifier": "SSH1920C0C97402...7B1B1A97F33C9C3",
  "nonce": "124074e7",
  "merchantIdentifier": "10DDB60D113BB4...CDF76292133",
  "domainName": "your-domain.com",
  "displayName": "My store",
  "signature": "308006092...2f5d0c8000000000000",
  "operationalAnalyticsIdentifier": "My store:10DDB60D113BB4...CDF76292133",
  "pspId": "psp-id-value",
  "retries": 0
}