2024 年 2 月的更新

付款对象和响应信息有了一些更新。请查看以下更新。

交易记录
小费金额
无效的交易响应消息
社区区域

交易记录

我们已向该对象添加了新内容。付款对象响应称为 transactions_history这是一个对象数组，表示构成某笔付款的交易列表。金额为交易这将取决于您在支付方式路径中设置了多少个供应商。

小费金额

我们在付款对象在……内部 additional_data.order 名为struct的结构体 tip_amount该字段代表订单的小费金额。此字段仅供参考，小费金额已包含在最终交易金额中，不会单独添加。

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"
              }
           }
        }
    }
}
'

有关更多信息，请参阅付款金额明细文档。

无效的交易响应消息

我们已向该页面添加了新信息。 response_message 当捕获事务正在尝试执行且已有事务正在处理时，API调用的响应。

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

社区

我们在客户对象在……内部 shipping_addres和 billing_address 被称为 neighborhood它代表客户地址行的邻域（最大值255；最小值3）。