Recursos para IA
Crear sesión de Apple Pay

Crea una nueva sesión de pago Apple Pay para procesar pagos a través del gateway de Apple Pay. En caso de éxito, la solicitud devolverá una respuesta con el estado 201.

POST

https://api.mercadopago.com/applepay/v1/session
Request parameters
Header
Authorization
string

REQUERIDO

Access Token obtenido a través del panel de desarrollador. Obligatorio ser enviado en todas las solicitudes.
X-Product-ID
string

REQUERIDO

Identificador del producto.
X-Public-Key
string

REQUERIDO

Public Key (clave pública) de tu aplicación de Mercado Pago, utilizada en el frontend. Usa la Public Key de prueba en el entorno de pruebas y la productiva en producción. Puedes obtenerla en Tus integraciones > Detalles
Body
id
string

REQUERIDO

Certificate ID del certificado tipo merchant. Este valor es devuelto en la respuesta a la requisición /certificates/csr/generate.
merchantIdentifier
string

REQUERIDO

Merchant ID configurado en el Portal Apple Developer.
domainName
string

REQUERIDO

Nombre de dominio donde se usará la sesión de pago. Debe coincidir con el dominio verificado en el Portal Apple Developer.
displayName
string

REQUERIDO

Nombre de tu tienda o comercio que ve el comprador en el flujo de pago de Apple Pay.
Response parameters
epochTimestamp
integer
Fecha y hora de creación de la sesión, como timestamp Unix en milisegundos (milisegundos transcurridos desde el 1 de enero de 1970 UTC).
expiresAt
integer
Fecha y hora de expiración de la sesión, como timestamp Unix en milisegundos (milisegundos transcurridos desde el 1 de enero de 1970 UTC).
merchantSessionIdentifier
string
Identificador de la sesión de Apple Pay. Envíalo a tu frontend para completar el flujo de pago con Apple.
nonce
string
Valor aleatorio usado con fines de seguridad.
Errores

400Error de solicitud.

invalid_request

El cuerpo de la solicitud está mal formado o falta un campo obligatorio. Revisa la estructura JSON y los parámetros requeridos.

invalid_parameter

Uno de los parámetros tiene un valor o formato inválido. Revisa los valores aceptados para cada campo.

401Error de autenticación.

unauthorized

Las credenciales enviadas son inválidas o están ausentes. Verifica que estés enviando credenciales válidas para el entorno que estás utilizando.

500Error del servidor.

internal_server_error

Ocurrió un error interno en el servidor. Espera un momento y vuelve a intentarlo. Si el problema persiste, comunícate con Soporte informando el 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
}