Recursos para IA
Tokenizar pago de Apple Pay

Recibe los datos de pago de Apple Pay cifrados, los descifra, tokeniza la información de la tarjeta y devuelve un card token para el procesamiento del pago con la Orders API. En caso de éxito, la solicitud devolverá una respuesta con el estado 200. Luego utiliza el card token devuelto para crear el pago con la Orders API.

POST

https://api.mercadopago.com/platforms/pci/applepay/v1/tokenize
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
X-Request-ID
string
Identificador de solicitud para fines de trazabilidad.
Body
payment_method
object

REQUERIDO

Información del medio de pago.
transaction_identifier
string

REQUERIDO

Identificador único de transacción generado por Apple para cada transacción.
device
object
Información del dispositivo para prevención de fraudes.
Response parameters
id
string
Card token. Envíalo como payment_method.token al crear el pago con la Orders API.
bin
string
Primeros dígitos de la tarjeta.
Errors

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.

424Error de dependencia.

failed_dependency

Falló una dependencia externa necesaria para completar la operación. Espera un momento y vuelve a intentarlo.

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.

502Error de gateway.

bad_gateway

Se recibió una respuesta inválida de un servicio superior. Espera un momento y vuelve a intentarlo.

503Servicio no disponible.

service_unavailable

El servicio está temporalmente no disponible. Espera un momento y vuelve a intentarlo.

Request
curl -X POST \
    'https://api.mercadopago.com/platforms/pci/applepay/v1/tokenize'\
    -H 'Content-Type: application/json' \
       -H 'Authorization: Bearer APP_USR-8*********88776-122*********fc20dede6*********a497d7225*********64' \
       -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"
}