Skip to main content
Un Refund es una reversión total o parcial de un pago, emitida con Refund Payment. Registra cuánto se movió, a través de qué proveedor y si se completó correctamente. Usa la API de Refunds para listar los reembolsos de un pago o de toda una cuenta, y para obtener un reembolso individual.

Endpoints

Atributos

string
requerido
ID del reembolso, con el prefijo rf_.
string | null
requerido
La cuenta que emitió el reembolso, con el prefijo biz_.
object | null
requerido
El importe reembolsado tal como se liquidó, en la divisa de liquidación del pago, para que las páginas de reembolsos se compensen con el refunded_amount del pago. Se convierte al tipo de cambio vigente cuando se emitió el reembolso, no al tipo original del pago. Es null solo cuando no hay ningún tipo de cambio registrado para un pago multidivisa heredado.

Propiedades

string
requerido
El importe en unidades principales, como cadena decimal exacta. Por ejemplo, "10.00" son diez dólares. Es una cadena para que ningún número de coma flotante lo redondee en tránsito.
string
requerido
Código de divisa ISO 4217 de tres letras, en minúsculas.
integer
requerido
Cuántos decimales tiene el importe. Es la precisión con la que se ejecuta el propio cargo.
integer
requerido
Cuántos decimales se deben MOSTRAR. Normalmente es igual a decimals, y deliberadamente no siempre: COP se cobra en centavos pero se escribe en pesos enteros, por lo que es 2 y 0. Usa esto para dar formato al número en tu propia configuración regional.
string
requerido
Cuándo se solicitó el reembolso, como marca de tiempo ISO 8601.
string | null
requerido
Una explicación para el comerciante de por qué falló el reembolso, en el idioma de la solicitud. Es null a menos que el reembolso haya fallado o se haya cancelado.
string | null
requerido
Por qué falló el reembolso, normalizado entre proveedores. Es null a menos que el reembolso haya fallado o se haya cancelado.Opciones disponibles: bank_declined, expired_or_canceled_card, lost_or_stolen_card, insufficient_funds, charge_disputed, not_refundable, merchant_request, unknown
object | null
requerido
Tus propios datos clave-valor adjuntados cuando se solicitó el reembolso.
object
requerido
El importe reembolsado en la divisa que movió el procesador.

Propiedades

string
requerido
El importe en unidades principales, como cadena decimal exacta. Por ejemplo, "10.00" son diez dólares. Es una cadena para que ningún número de coma flotante lo redondee en tránsito.
string
requerido
Código de divisa ISO 4217 de tres letras, en minúsculas.
integer
requerido
Cuántos decimales tiene el importe. Es la precisión con la que se ejecuta el propio cargo.
integer
requerido
Cuántos decimales se deben MOSTRAR. Normalmente es igual a decimals, y deliberadamente no siempre: COP se cobra en centavos pero se escribe en pesos enteros, por lo que es 2 y 0. Usa esto para dar formato al número en tu propia configuración regional.
string
requerido
El pago que revierte este reembolso, con el prefijo pay_.
string
requerido
El proveedor de pagos que procesó el reembolso, como paypal o coinbase.
string | null
requerido
Cuándo creó el proveedor el reembolso, como marca de tiempo ISO 8601.
string | null
requerido
Por qué se emitió el reembolso, cuando está registrado.Opciones disponibles: duplicate, fraudulent, requested_by_customer, expired_uncaptured_charge, dispute_alert
string | null
requerido
Si hay disponible una referencia de seguimiento de la red bancaria para este reembolso.Opciones disponibles: available, pending, unavailable
string | null
requerido
El tipo de referencia de seguimiento, como un número de referencia del adquirente.Opciones disponibles: acquirer_reference_number, retrieval_reference_number, system_trace_audit_number
string | null
requerido
La referencia de seguimiento con la que el banco del comprador puede rastrear el reembolso.
string
requerido
En qué estado está el reembolso con el procesador: pending, requires_action, succeeded, failed o canceled.Opciones disponibles: pending, requires_action, succeeded, failed, canceled
string
requerido
Cuándo cambió el reembolso por última vez, como marca de tiempo ISO 8601.
boolean
requerido
True cuando la red de tarjetas inició el reembolso mediante Rapid Dispute Resolution.
Refund