Reembolsos sin referencia
Crear reembolso sin referencia
Crea un reembolso sin referencia (crédito independiente).
POST
Esta solicitud te permite crear un reembolso sin referencia: un crédito enviado directamente a un método de pago sin hacer referencia a una transacción de pago original.
Cuándo usar los reembolsos sin referenciaUsa este endpoint cuando el cargo original se procesó fuera de Yuno (sistema de facturación heredado, motor de suscripciones externo) o cuando necesitas enviar un crédito de cortesía o promocional. Para revertir un pago capturado por Yuno, usa en su lugar el endpoint Reembolsar pago con transacción.La cuenta del proveedor debe permitir los reembolsos sin referencia. Algunos proveedores lo habilitan por cuenta de comercio (Adyen, por ejemplo), así que confírmalo con el proveedor antes de usar este endpoint.
Datos sin procesar del proveedorEl objeto
provider incluye el intercambio con el proveedor sin modificar en dos campos. La forma de ambos la define el proveedor, no Yuno, por lo que varía según el proveedor y la operación.raw_response_code y raw_response_message son resúmenes de la respuesta del proveedor y siempre se devuelven, independientemente de los dos campos anteriores.La clave de API pública única de tu cuenta. La encuentras en el dashboard de Yuno.
La clave secreta privada única de tu cuenta. La encuentras en el dashboard de Yuno.
Identificador UUID v4 único que se usa para reintentar la solicitud de forma segura. Los reintentos con la misma clave devuelven el reembolso creado originalmente.
El identificador único de la cuenta. Encuentras esta información en el dashboard de Yuno (UUID, 36 caracteres).
La descripción del reembolso. Aparece en los dashboards y en los extractos (MAX 255; MIN 3).
País donde se debe procesar el reembolso (MAX 2; MIN 2; ISO 3166-1). Determina el enrutamiento al proveedor.
Fija el reembolso a un gateway específico, omitiendo las reglas de enrutamiento. Es útil cuando el proveedor de destino lo determina el lugar donde se procesó el pago original.
Especifica el destino del reembolso: token almacenado en el vault, tarjeta sin procesar, transferencia bancaria o billetera. Se debe definir exactamente uno de
vaulted_token o detail.<card|wallet|bank_transfer>.Especifica el destinatario del reembolso. Obligatorio para destinos ACH, SEPA y PayPal, para cumplir con los controles de OFAC y AML.
Lista opcional de pares clave/valor para tu propia referencia. Se devuelve en la respuesta y en el payload del webhook.
URL HTTPS donde Yuno entregará los eventos de webhook de este reembolso. Si se omite, usa el webhook de nivel de cuenta.
Cuando
stand_alone: true, Yuno ejecuta una verificación de fraude con ML antes de enviar la solicitud al proveedor. Recomendado para reembolsos a tarjetas sin procesar.