Actualizaciones de febrero de 2024

Se han realizado algunas actualizaciones en el objeto de Pagos y en los mensajes de respuesta. Consulte las actualizaciones a continuación.

Historial de transacciones
Monto de la propina
Mensaje de respuesta de transacción no válida
Campo de barrio

Historial de transacciones

Hemos añadido un nuevo objeto al pago llamado transactions_history. Es una matriz de objetos que representa la lista de las transacciones que forman parte de un pago. El monto de transacciones dependerá de cuántos proveedores haya configurado en tu ruta de método de pago.

Monto de la propina

Hemos añadido un nuevo campo a pago dentro de la estructura additional_data.order llamada tip_amount. Representa el importe de la propina del pedido. Este campo es informativo, el importe de la propina ya está incluido en el importe final de la transacción y no se suma por separado.

curl --request POST \
     --url https://api-sandbox.y.uno/v1/payments \
     --header 'X-Idempotency-Key: <Your idempotency-key>' \
     --header 'accept: application/json' \
     --header 'content-type: application/json' \
     --header 'private-secret-key: <Your private-secret-key>' \
     --header 'public-api-key: <Your public-api-key>' \
     --data '
{
    "description": "Test",
    "account_id": "{{account-code}}",
    "merchant_order_id": "0000023",
    "country": "CO",
    "merchant_reference" : "reference-{{$randomUUID}}",
    "amount": {
        "currency": "COP",
        "value": 5000.00
    },
    "customer_payer": {
        "id":"967ecd18-d898-4b88-9400-dd5b01b18edc"
    },
    "additional_data": {
          "order": {
              "tip_amount": 50.00
          }
      },
    "workflow": "DIRECT",
    "payment_method": {
        "type":"CARD",
        "vaulted_token": "eb8caa17-6407-457b-960e-125d8d7a90c1",
        "detail": {
           "card": {
               "stored_credentials":{
                  "reason":"CARD_ON_FILE",
                  "usage": "USED"
              }
           }
        }
    }
}
'

Para obtener más información, consulta la documentación sobre los detallespago .

Mensaje de respuesta de transacción no válida

Hemos añadido nueva información a la response_message de la llamada API cuando se intenta realizar una transacción de captura y ya hay una en proceso.

{  
    "code": "INVALID_STATUS",  
    "messages": [  
        "Invalid transaction status. Transaction already in progress"  
    ]  
}

Vecindario

Hemos añadido un nuevo campo a Objeto de cliente dentro de la estructura shipping_addresy billing_address llamado neighborhood. Representa la vecindad de la línea de dirección del cliente (MAX 255; MIN 3).