2024 年 8 月的更新

探索支付对象的最新增强功能，包括订阅协议 ID、货币转换支持以及取消或退款功能。请查看以下更新。

付款对象有了一些更新。请查看以下更新。

订阅协议 ID
交易中的支付
涉及货币转换的支付
ISO代码与消息
取消或退款

订阅协议ID

对于某些市场（例如 MX）和支付处理程序，在进行与订阅相关的支付时，需要在支付请求中指定与客户签订的协议的 ID，以确保正确处理。为此，我们启用了 subscription_agreement_id 字段内的 stored_credentials 结构，允许您与客户共享所达成的协议。

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

请查阅存储凭据指南文档以获取更多详细信息。

交易中的支付

根据提供商的不同，可以向不同的付款方式（如银行账户甚至银行卡）付款。如果商家没有信用卡信息（不符合 PCI 标准），Yuno 允许商家通过信用卡支付方式进行支付。这称为 "参考支付"。

要使用此功能，您需要先通过我们的PCI合规解决方案（任何Yuno SDK）完成客户扣款，随后发起一笔付款请求，并在其中注明原始交易记录以便我们获取信用卡信息。

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

请查阅支付说明文档以获取更多详细信息。

涉及货币转换的支付

Yuno 的货币兑换服务可让您以自己的货币和客户的货币进行结算。货币兑换是将一种货币兑换成另一种货币的过程。它涉及使用汇率来确定目标货币的等值金额。

商家可使用外部供应商的货币转换服务，并在Yuno支付中直接发送相应信息。使用此功能前，请联系您的技术客户经理确保信息设置正确，因为货币转换率必须由供应商的外部服务提供。示例：

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

请查阅货币转换文档以获取更多详细信息。

ISO代码与消息

我们已向 Payment object 被称为 iso8583_response_code 和 iso8583_response_message这两个字段均代表发卡机构针对金融交易卡国际标准转账信息（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"

若支付服务商返回ABECS（巴西信用卡与服务公司协会）代码，这些代码将显示在iso_code_response_code和message字段中。

请查看支付对象以获取更多详细信息。

取消或退款

我们已添加一个新功能在支付API中，您只需提供 payment id与……相反现有服务其中 transaction_id 是必需的。请检查付款 API 参考文档以获取更多详细信息。