2024 年 11 月的更新

了解 Yuno 的最新更新，包括银行卡过期详情、增强型拆分支付、退款收据、订阅项目和使用金库tokens支付。请查看以下更新。

关于 Yuno 有一些更新。请查看以下更新。

卡片到期详情
分拆支付市场接收方
取消交易的收据
订阅项目
使用保险库tokens进行支付

卡片到期详情

我们在支付响应中新增了两个字段，名为 expiration_year 和 expiration_month这些字段（位于每个交易记录的card_data内）指定了用于支付的卡片到期详情，无需调用支付方式获取即可直接获取相关信息。

[...]
"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
[...]

拆分市场接收方

我们在分拆支付市场请求中新增了一项名为"收款方"的功能。若您为分拆支付使用多个支付服务商，建议采用收款方对象，该对象支持为每个收款方配置多个支付服务商。

收件人创建

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

发送付款

[...],
"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"
                }
            ],
[...]

如需了解更多信息，请参阅API指南部分中的分次付款市场请求。

退款交易收据

我们在退款请求中新增了一项名为"收据"的功能。该功能可让您为Yuno平台内每笔退款交易获取收据。由于Yuno并不实际向收单机构执行退款操作，此收据代表着向服务商提交退款请求的执行凭证，用于退还先前完成的购买交易。

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

退款生成后，您可以执行支付款项在"receipt_url"字段中查找生成的收据 payment.transaction 反对

有关更多信息，请参阅API参考部分中的退款请求。

订阅项目

我们在订阅功能中新增了一项名为"附加数据"的功能。现在，Yuno允许您指定与订阅相关的项目信息，以便我们将这些信息发送给供应商。

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

有关更多信息，请参阅订阅 API参考部分。

使用保险库tokens进行支付

我们为Payouts产品新增了一项功能，允许您直接向Yuno中已绑定的信用卡/借记卡发起支付请求（需服务商支持该功能）。

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

如需了解更多信息，请参阅：

招生指南部分，用于招生流程说明。
支付API参考部分：支付创建