---
title: "Configurar Mastercard"
method: POST
path: "/onboarding/mastercard"
tags: ["Wallets"]
---

# Configurar Mastercard

`POST /onboarding/mastercard`

## Request

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

Mediante este método se configuran los servicios de Mastercard (Click to Pay y scheme token) para el comercio indicado en `client_uuid`, que debe pertenecer al cliente que realiza la petición. Si el comercio no tenía la wallet configurada, ésta se crea; en caso contrario se actualiza con los datos enviados.

Ambos bloques son opcionales e independientes, por lo que puede enviarse solamente el que se desee configurar. Al enviar `click_to_pay.dpa_name` el comercio se registra en Click to Pay y Mastercard devuelve el `dpa_id` que PaynoPain almacena; si el nombre no cambia respecto al ya registrado, el registro no se repite.

Puede consultarse el detalle de la configuración en la [documentación de Click to Pay](https://docs.paylands.com/docs/wallets/mastercard-clicktopay).

## Parameters

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

## Request body

- object
  - `signature` Signature, required (unresolved $ref)
  - `client_uuid` Uuid, required (unresolved $ref)
  - `click_to_pay` object, nullable: Configuración de Click to Pay. Si se omite, la configuración existente no se modifica.
    - `dpa_name` string, nullable: Nombre comercial que se mostrará al usuario en Click to Pay. Al enviarlo, el comercio se registra o se actualiza en Click to Pay, por lo que debe acompañarse de country_code. Si no se indica, se utiliza el nombre del comercio.
    - `country_code` string, nullable: Código alfanumérico de tres letras ISO 3166 del país del comercio. Actualmente sólo se soporta ESP.
    - `dpa_shipping_preference` 'FULL' | 'NONE': Indica si Click to Pay debe solicitar la dirección de envío al usuario.
    - `dpa_billing_preference` 'FULL' | 'NONE': Indica si Click to Pay debe solicitar la dirección de facturación al usuario.
    - `consumer_name_requested` boolean, nullable: Indica si Click to Pay debe solicitar el nombre al usuario.
    - `consumer_email_address_requested` boolean, nullable: Indica si Click to Pay debe solicitar el email al usuario.
    - `consumer_phone_number_requested` boolean, nullable: Indica si Click to Pay debe solicitar el teléfono al usuario.
    - `is_enabled` boolean, nullable: Indica si Click to Pay queda habilitado para el comercio.
  - `scheme_token` object, nullable: Configuración del scheme token de Mastercard (MDES). Si se omite, la configuración existente no se modifica.
    - `dpa_id` string, nullable: Identificador del DPA facilitado por Mastercard para la tokenización.
    - `service_id` string, nullable: Identificador del servicio facilitado por Mastercard para la tokenización.
    - `is_enabled` boolean, nullable: Indica si el scheme token 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/mastercard/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)