Saltar al contenido principal
PATCH
Reasignar un método de pago a otro cliente
Reasigna un método de pago inscrito a un cliente distinto de la misma cuenta. Envía el customer_id del cliente de destino en el cuerpo de la solicitud. Solo se pueden reasignar métodos de pago de tipo tarjeta. La respuesta devuelve el método de pago con la misma estructura que la respuesta de Enroll Payment Method, con el nuevo propietario en el campo customer_id.
Para reasignar el método de pago, debes proporcionar el payment_method_id, que es el vaulted_token recibido al usar el endpoint Enroll Payment Method.
Un método de pago que ya está asignado a un cliente que tiene datos no se puede reasignar, y la solicitud se rechaza con 409 CONFLICT.
Después de reasignar un método de pago, el comercio es responsable de actualizar el identificador del cliente en todos los lugares donde ya se usó el método de pago. Esto incluye cualquier suscripción creada con él, el mapeo propio del comercio entre un usuario y el vaulted_token, y cualquier par almacenado de cliente y método de pago. Yuno reasigna el método de pago al nuevo cliente, pero no actualiza esas referencias del lado del comercio.

Autorizaciones

public-api-key
string
header
predeterminado:<Your public-api-key>
requerido
private-secret-key
string
header
predeterminado:<Your private-secret-key>
requerido

Encabezados

X-account-code
string
requerido

El identificador único de tu cuenta (UUID).

Parámetros de ruta

payment_method_id
string
requerido

El identificador único del payment_method. Es el vaulted_token recibido al inscribir un método de pago con Enroll Payment Method (UUID).

Cuerpo

application/json
customer_id
string
requerido

El identificador único del cliente al que se reasigna el método de pago (UUID). El método de pago solo se puede reasignar mientras su cliente actual no tenga datos; de lo contrario, la solicitud devuelve 409 CONFLICT.

Respuesta

El método de pago reasignado, con el nuevo propietario en el campo customer_id.

idempotency_key
string
Ejemplo:

"a0000000-0000-4000-8000-000000000010"

name
string
Ejemplo:

"VISA ****1111"

description
string
Ejemplo:

"VISA ****1111"

type
string
Ejemplo:

"CARD"

category
string
Ejemplo:

"CARD"

country
string
Ejemplo:

"US"

parent_type
any
status
string
Ejemplo:

"ENROLLED"

sub_status
string
Ejemplo:

"ENROLLED"

vaulted_token
string
Ejemplo:

"b0000000-0000-4000-8000-000000000002"

callback_url
any
action
any
redirect_url
any
created_at
string
Ejemplo:

"2024-06-04T12:47:46.992602Z"

updated_at
string
Ejemplo:

"2024-06-04T12:47:46.992603Z"

card_data
object
last_successfully_used
any
last_successfully_used_at
any
preferred
any
customer_id
string

El identificador único del cliente al que ahora pertenece el método de pago. Lo devuelve la respuesta de la reasignación para que puedas confirmar el nuevo propietario.

Ejemplo:

"b3f2c1a0-1234-4a5b-9c8d-000000000001"

verify
any