Saltar al contenido principal
POST
Reembolsar pago (dos tarjetas)
Esta solicitud reembolsa una tarjeta de un pago creado con Create Payment (two cards). El reembolso es por tarjeta: envía el id de la transacción PURCHASE o CAPTURE de esa tarjeta en payment_method.payment_methods[].transactions. Si omites amount, la tarjeta se reembolsa por completo. Un reembolso sobre una tarjeta tiene como tope el monto de esa tarjeta menos lo que ya se reembolsó en ella. Después de reembolsar una tarjeta, el pago queda en SUCCEEDED / PARTIALLY_REFUNDED; después de ambas, queda en REFUNDED / REFUNDED. La respuesta es 201 con el pago en el formato v2.
Mientras una tarjeta tiene un contracargo abierto, los reembolsos son rechazados con INVALID_STATUS.
Esta solicitud requiere un X-Idempotency-Key. Consulta Authentication para obtener más detalles.

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-Idempotency-Key
string<uuid>
requerido

Clave única de esta solicitud. Obligatoria en cada solicitud de pago v2. Si el resultado no es claro, reintenta con la misma clave. Sin ella, la solicitud se rechaza con 400 INVALID_PARAMETERS: "The header 'x-idempotency-key' is required."

Parámetros de ruta

payment_id
string<uuid>
requerido

El id del pago devuelto por POST /v2/payments.

transaction_id
string<uuid>
requerido

El id de la transacción de la tarjeta sobre la que operar, de payment_method.payment_methods[].transactions[].

Cuerpo

application/json
merchant_reference
string
requerido

Identificación de la transacción de pago definida por el comercio (MAX 255; MIN 3).

description
string

Descripción del reembolso. (MAX 255; MIN 3).

reason
enum<string>

Motivo de la operación. Los valores posibles son DUPLICATE, FRAUDULENT y REQUESTED_BY_CUSTOMER.

Opciones disponibles:
DUPLICATE,
FRAUDULENT,
REQUESTED_BY_CUSTOMER
amount
object

Opcional. Monto a reembolsar en esta tarjeta. Si lo omites, la tarjeta se reembolsa por completo.

customer_payer
object

Indica el objeto customer de los pagos.

payment_method
object

Especifica el objeto de método de pago para los pagos.

Respuesta

El pago después de la operación, con la estructura v2

Un pago financiado con dos tarjetas.

id
string<uuid>
account_id
string<uuid>
description
string
country
string
status
string

Estado agregado del pago. Consulta Pagar con dos tarjetas.

sub_status
string

Subestado agregado, por ejemplo APPROVED, AUTHORIZED, PARTIALLY_CAPTURED, PARTIALLY_REFUNDED, REFUND_RETRY_IN_PROCESS o CANCEL_RETRY_IN_PROCESS.

merchant_order_id
string
merchant_reference
string
created_at
string<date-time>
updated_at
string<date-time>
split_payment_methods
boolean

true para un pago financiado con dos tarjetas.

payment_methods_count
integer

Número de tarjetas que financian el pago: 2.

sdk_action_required
boolean

true cuando el SDK debe continuar el pago, por ejemplo para ejecutar un desafío 3DS.

amount
object

Total del pago.

checkout
object
payment_method
object
customer_payer
object

El pagador, tal como se envió en la solicitud.

additional_data
object | null
callback_url
string
workflow
enum<string>
Opciones disponibles:
DIRECT,
REDIRECT,
SDK_CHECKOUT
metadata
object[]