Actualizaciones de agosto de 2024

Explora las últimas mejoras del objeto Pagos, incluidos los identificadores de los acuerdos de suscripción, la compatibilidad con la conversión de divisas y la posibilidad de cancelar o reembolsar pagos. Consulta las actualizaciones a continuación.

Se han producido algunas actualizaciones en el objeto Pagos. Consulta las actualizaciones a continuación.

ID del acuerdo de suscripción
Pagos con transacciones
Pagos con conversión de divisas
Código ISO y mensaje
Cancelar o reembolsar un pago

ID del contrato de suscripción

En algunos mercados (por ejemplo, MX) y procesadores de pago, cuando se realiza un pago relacionado con una suscripción, es necesario especificar el ID del acuerdo con el cliente en la solicitud de pago para garantizar un procesamiento correcto. Para facilitar esto, hemos habilitado la opción subscription_agreement_id dentro de la estructura stored_credentials que le permite compartir el acuerdo realizado con el cliente.

"payment_method": {
        "type":"CARD",
        "vaulted_token": "eb8caa17-6407-457b-960e-125d8d7a90c1",
        "detail": {
           "card": {
               "stored_credentials":{
                  "reason":"CARD_ON_FILE",
                  "usage": "USED",
                  "subscription_agreement_id":"AA0001"
              }
           }
        }
    }

Consulta la documentación de la guía de credenciales almacenadas para obtener más detalles.

Pagos con transacciones

Los payouts se pueden realizar a diferentes métodos de pago, como cuentas bancarias e incluso tarjetas, según el proveedor. En el caso de los payouts a un método de pago con tarjeta en el que el comerciante no tiene la información de la tarjeta de crédito (no cumple con la normativa PCI), Yuno le permite enviar el payout si la tarjeta se utilizó anteriormente en un pago. Esto se denomina "Payout referenciado".

Para poder utilizar esta función, primero deberás cobrar al cliente utilizando una de nuestras soluciones compatibles con PCI (cualquier SDK de Yuno) y, a continuación, realizar un pago indicando la transacción original en la que podemos encontrar la información de la tarjeta de crédito.

"withdrawal_method": {
    "type": "STP_PAYOUT",
    "provider_id": "STP",
    "original_transaction_id":"9104911d-5df9-429e-8488-ad41abea1a4b"
  }

Consulta la documentación sobre pagos para obtener más información.

Pagos con conversión de divisas

El servicio de conversión de divisas de Yuno le permite liquidar pagos tanto en tu divisa como en la de tu cliente. La conversión de divisas es el proceso de convertir una divisa en otra. Consiste en utilizar los tipos de cambio para determinar el importe equivalente en la divisa de destino.

El comerciante puede utilizar el servicio de conversión de divisas de un proveedor externo y enviar la información correspondiente directamente en el pago Yuno. Para utilizar este servicio, ponte en contacto con tu gestor técnico de cuentas para asegurarte de que la información está configurada correctamente, ya que el tipo de cambio debe ser proporcionado por un servicio externo del proveedor. Ejemplo:

"amount": {
        "currency": "COP",
        "value": 5000, 
        "currency_conversion": {
            "provider_currency_conversion_id": "AAA01SADOIAJSDLAKSJM",
            "cardholder_currency": "ARS",
            "cardholder_amount": 1146.55    
        }
    }

Consulta la documentación sobre conversión de divisas para obtener más información.

Código ISO y mensaje

Hemos añadido dos nuevos campos al Payment object llamado iso8583_response_code y iso8583_response_messageAmbos campos representan la respuesta directa del proveedor con respecto al estándar internacional para mensajes de intercambio originados por tarjetas de transacciones financieras (ISO 8583).

"transactions": {
        "id": "4450529a-a5f9-4856-9ba9-21aed302e209",
        "type": "PURCHASE",
        "status": "SUCCEEDED",
        "category": "CARD",
        "amount": 5000.00,
        "provider_id": "ADYEN",
        "payment_method": {
              ...
        },
        "response_code": "SUCCEEDED",
        "response_message": "Transaction successful",
        "reason": null,
        "description": "SUCCEDED",
        "merchant_reference": "1234",
        "provider_data": {
            "id": "ADYEN",
            "transaction_id": "FLX4WSXF7SFZDV65",
            "account_id": "YunoPayments_Sandbox_TEST",
            "status": "Authorised",
            "status_detail": "Authorised",
            "response_message": null,
            "response_code": null,
            "iso8583_response_code": "05",
            "iso8583_response_message": "Approved or completed successfully"

Si el pago devuelve los códigos ABECS (Asociación Brasileña de Empresas de Tarjetas de Crédito y Servicios), estos se mostrarán en los campos iso_code_response_code y message.

Consulta el objeto de pagos para obtener más detalles.

Cancelar o reembolsar un pago

Hemos añadido un nueva funcionalidad a la API de pagos, donde puedes cancelar o reembolsar un pago proporcionar el payment id, al contrario que servicio existente donde es necesario el transaction_id. Por favor, comprueba el pagos Referencia API para más detalles.