Actualizaciones de noviembre de 2024

Descubre las últimas novedades de Yuno, como detalles sobre el vencimiento de las tarjetas, pagos fraccionados mejorados, recibos de reembolso, artículos de suscripción y pagos con tokens almacenados. Consulta las actualizaciones a continuación.

Se han producido algunas actualizaciones en Yuno. Consulta las actualizaciones a continuación.

Detalles de vencimiento de la tarjeta
Destinatarios del Mercado de Pagos Fraccionados
Recibos de transacciones canceladas
Artículos para suscripciones
Pagos con tokens almacenados en bóveda

Detalles de vencimiento de la tarjeta

Hemos agregado dos campos más a la respuesta de Pago llamados expiration_year y expiration_monthLos campos (dentro de cada transaction.card_data) especifican los detalles de vencimiento de la tarjeta utilizada para realizar el pago, brindándote la información sin tener que acceder al método de pago.

[...]
"card_data": {
                    "holder_name": "Paco",
                    "iin": "48710499",
                    "lfd": "9910",
                    "number_length": 16,
                    "security_code_length": 3,
                    "brand": "VISA",
                    "issuer_name": "BNP PARIBAS FORTIS",
                    "issuer_code": null,
                    "country_code": "BE",
                    "category": "CLASSIC",
                    "type": "DEBIT",
                    "three_d_secure": {
                        "version": null,
                        "electronic_commerce_indicator": null,
                        "cryptogram": null,
                        "transaction_id": null,
                        "directory_server_transaction_id": null,
                        "pares_status": null,
                        "acs_id": null
                    },
                    "fingerprint": "71000db4-f8e7-4ea0-a2cc-9d9ebb76a955",
                    "expiration_month": 3,
                    "expiration_year": 30
[...]

Destinatarios de Split Marketplace

Hemos añadido una nueva función a las solicitudes del mercado de pagos fraccionados denominada «Destinatarios». Si utilizas más de un pago para los pagos fraccionados, te recomendamos que utilices el objeto «destinatarios», ya que te permite definir más de un proveedor para cada destinatario.

Creación de destinatarios

{
    "account_id": "{{account-code}}",
    "providers": [{
        "id": "PAGARME",
        "recipient_id": "XXXXXXXX"
    }],
    "external_id": "AAAA05",
    "national_entity": "INDIVIDUAL",
    "first_name": "John",
    "last_name": "Doe",
    "legal_name": "Arcos dorados S.A.",
    "email": "[email protected]",
    "country": "CO",
    "document": {
        "document_number": "1093333333",
        "document_type": "CC"
    },
    "phone": {
        "country_code": "57",
        "number": "3132450765"
    },
    "address": {
        "address_line_1": "Calle 34 # 56 - 78",
        "address_line_2": "Apartamento 502, Torre I",
        "city": "Bogota",
        "country": "CO",
        "state": "Cundinamarca",
        "zip_code": "111111"
    }
}

Enviar un pago

[...],
"amount": {
        "currency": "BRL",
        "value": 1000
    },
"split_marketplace": [
                {
                    "amount": {
                        "currency": "BRL",
                        "value": 500
                    },
                    "recipient_id": "09d8bad7-4efe-47e2-b9ee-f4028460bab1",
                    "type": "PURCHASE"
                },
                {
                    "amount": {
                        "currency": "BRL",
                        "value": 500
                    },
                    "recipient_id": "d94e02c1-cc47-4e60-a20a-2b17fe58992d",
                    "type": "PURCHASE"
                }
            ],
[...]

Para obtener más información, consulta el mercado de pagos fraccionados pedido la sección de guías de API.

Recibos de transacciones de reembolso

Hemos añadido una nueva función a las solicitudes de reembolso denominada Recibos. Esta función te permite obtener un recibo por cada transacción de reembolso realizada en Yuno. Como Yuno no ejecuta realmente el reembolso a los adquirentes, este recibo representa la ejecución de la solicitud al proveedor para reembolsar la compra realizada anteriormente.

{
  "description": "Duplicate",
  "reason": "REQUESTED_BY_CUSTOMER",
  "merchant_reference": "AAB01-432245",
  "response_additional_data": 
    	{
          "receipt": true,
          "receipt_language": "ES"
        }
}

Una vez creado el REEMBOLSO, puedes hacer un salir del pago para encontrar el recibo creado en el campo «receipt_url» en el payment.transaction .

Para obtener más información, consulta la sección «Refund pedido la sección de referencia de la API.

Artículos para suscripciones

Hemos añadido una nueva función a la característica Suscripción llamada Datos adicionales. Ahora Yuno te permite especificar información sobre los artículos relacionados con la suscripción para que podamos enviar esa información a los proveedores.

{
  "name": "Test Subscription",
  "description": "Subscription Test",
  "merchant_reference": "subscription-ref-merchant-AA01",
  "account_id": "{{account-code}}",
  "country": "BR",
  "additional_data": {
    "order": {
      "items": [
        {
          "category": "art",
          "id": "AA01",
          "name": "Test item",
          "quantity": 1,
          "unit_amount": 10
        }
      ]
    }
  },
  "amount": {
    "currency": "BRL",
    "value": 1500
  },
  "frequency": {
    "type": "MONTH",
    "value": 1
  },
  "billing_cycles": {
    "total": 12
  },
  "customer_payer": {
    "id": "a1d3b664-e32a-4508-9da1-9ede3e62a60c"
  },
  "payment_method": {
    "type": "CARD",
    "vaulted_token": "d4aa3586-def2-4705-b7cd-fe064bb764e6"
  },
}
'

Para obtener más información, consulta la sección Referencia de la API de suscripciones.

Pagos con tokens almacenados en bóveda

Hemos añadido una nueva función al producto Pagos, que te permite crear solicitudes directamente a una tarjeta de crédito/débito registrada en Yuno, siempre que el proveedor lo admita.

[...],
"withdrawal_method": {
    "type": "CARD",
    "provider_id": "UNLIMINT",
    "vaulted_token":"[the payment method vaulted token]"
  }
[...]

Para obtener más información, consulte:

Sección de la guía de inscripción para el proceso de inscripción.
Sección de referencia de la API de pagos para la creación de pagos.