---
title: "Configurar Apple Pay"
method: POST
path: "/onboarding/applepay"
tags: ["Wallets"]
---

# Configurar Apple Pay

`POST /onboarding/applepay`

## Request

- Base URL: `https://api.paylands.com/v1/sandbox`
- URL: `https://api.paylands.com/v1/sandbox/onboarding/applepay`
- Auth: none required

Mediante este método se configura Apple Pay para el comercio indicado en `client_uuid`, que debe pertenecer al cliente que realiza la petición. Si el comercio no tenía Apple Pay configurado, la wallet se crea; en caso contrario se actualiza con los datos enviados.

En la modalidad `WEB` los dominios indicados en `domains` se registran automáticamente en Apple Pay. En la modalidad `APP` deben enviarse `merchant_id` y `certificate` para registrar el certificado del comercio.

Puede consultarse el detalle de cada modalidad de integración en la [documentación de Apple Pay](https://docs.paylands.com/docs/wallets/wallet-applepay).

## Parameters

- `#/paths/~1/get/parameters/0` (unresolved $ref)

## Request body

- object
  - `signature` Signature, required (unresolved $ref)
  - `client_uuid` Uuid, required (unresolved $ref)
  - `flow_type` 'WEB' | 'APP', required: Modalidad de integración a configurar. WEB para el botón en el checkout o en la web del comercio, APP para integraciones nativas en aplicaciones móviles.
  - `country_code` string, required: Código ISO 3166 del país del comercio, en formato alfa-2, alfa-3 o numérico. Determina la región con la que se configura Apple Pay.
  - `domains` string[], nullable: Obligatorio en la modalidad WEB. Dominios desde los que se mostrará el botón de Apple Pay. Se registran y validan en Apple Pay.
  - `merchant_id` string, nullable: Identificador de comercio de Apple Pay. Necesario, junto a certificate, para configurar la modalidad APP en producción. Si no se indica, se utiliza el UUID del comercio.
  - `certificate` string, nullable: Certificado de Apple Pay codificado en base64. Se utiliza en la modalidad APP en producción.
  - `merchant_name` string, nullable: Nombre del comercio que mostrará Apple Pay. Si no se indica, se utiliza el nombre del comercio.
  - `button_color` 'BLACK' | 'WHITE' | 'WHITEOUTLINE': Color del botón de Apple Pay que se mostrará al usuario.
  - `button_type` 'ADD-MONEY' | 'BOOK' | 'BUY' | 'CHECK-OUT' | 'CONTINUE' | 'CONTRIBUTE' | 'DONATE' | 'ORDER' | 'PAY' | 'PLAIN' | 'RELOAD' | 'RENT' | 'SET-UP' | 'SUBSCRIBE' | 'SUPPORT' | 'TIP' | 'TOP-UP': Tipo de botón de Apple Pay que se mostrará al usuario.
  - `shipping_address_required` boolean, nullable: Indica si Apple Pay debe solicitar la dirección de envío al usuario.
  - `billing_address_required` boolean, nullable: Indica si Apple Pay debe solicitar la dirección de facturación al usuario.
  - `only_debit` boolean, nullable: Restringe los pagos con Apple Pay a tarjetas de débito.
  - `is_enabled` boolean, nullable: Indica si Apple Pay queda habilitado para el comercio.

## Response `200`

OK

- ResponseOK
  - `message` string, required: Nombre del código HTTP de respuesta.
  - `code` number, required: Código de respuesta.
  - `current_time` string, required: Fecha y hora de la petición.

## Other responses

- `400`: Bad Request
- `404`: Not Found

## Changes

- **2026-09-02** `846291066bc2`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/paylands/apis/documentacio-n-de-paylands/changes/onboarding/applepay/post.md)

---

[API](https://skmtc.dev/paylands/apis/documentacio-n-de-paylands.md) - [All operations](https://skmtc.dev/paylands/apis/documentacio-n-de-paylands/llms.txt) - [OpenAPI document](https://skmtc.dev/paylands/apis/documentacio-n-de-paylands/revisions/6a6bfbb3c872?raw)