Translation disclaimer

Documentation is written in English and subsequently translated. This page, therefore, might not have the most up-to-date content. If any questions arise relating to the accuracy of the translated content, please refer to the English version of the page.

Menu

版本控制和更改日志

该日志详细描述了我们为支出服务发布的任何中断和非中断 API 更改。

前提条件:让自己熟悉我们的API 原则,以确保有弹性的集成。

版本控制日志

中断更改

版本 3 对商户响应进行了更新。

居里阵列块现在存在于 JSON 块_links内部

之前:

Copied!
{
    "outcome": "requestReceived",
    "receivedAt": "2020-05-06T12:29:39.625884Z",
    "_links": {
        "payouts:payout": {
            "href": "https://access.worldpay.com/payouts/{resource}"
        }
    },
    "curies": [
        {
            "name": "payouts",
            "href": "https://access.worldpay.com/rels/payouts/{rel}",
            "templated": true
        }
    ]
}

之后:

Copied!
{
    "outcome": "requestReceived",
    "receivedAt": "2020-05-06T12:29:39.625884Z",
    "_links": {
        "payouts:payout": {
            "href": "https://access.worldpay.com/payouts/{resource}"
        },
        "curies": [{
            "name": "payouts",
            "href": "https://access.worldpay.com/rels/payouts/{rel}",
            "templated": true
        }]
    }
}

中断更改

版本 2 引入了严格解析。

  • 头文件更改为 "Content-Type: application/vnd.worldpay.payouts-v2+json"
  • 描述性文本最大长度从 25 减少为 24
  • 发送文档中未记录的任何字段都将返回错误
  • 描述性文本在 JSON 块中现在有两个行:

之前:

Copied!
"narrative": "abc"

之后:

Copied!
"narrative": {
      "line1": "abc",
      "line2": "abc"
    }

注释:您可以在此处查找所有版本的文档。

更改日志(非中断更改)

针对 Payouts v2 和 v3,您可为basicDisbursementfastAccess请求提供 billingAddress。 当为 basicDisbursement 请求提供时,这些字段可提高成功率。对于 fasAccess 请求,您可以提供 billingAddress 字段。当 fastAccess 不可用且 Payout 默认设为 basicDisbursement 时,这非常有用。

cardExpiry 现在可以是用于您DbasicDisbursement 请求的过去某个日期,以便让您处理无参考号的退款。

payoutInstrument.cardHolderName 字段在 v2 和 v3 支出请求中不再为必需。

您现在可以请求 payoutInstrument card/networkToken+applepay支出

居里阵列块已更新,只能存在于 _links JSON 块内部以及外部

之前:

Copied!
{
    "outcome": "requestReceived",
    "receivedAt": "2020-05-06T12:29:39.625884Z",
    "_links": {
        "payouts:payout": {
            "href": "https://access.worldpay.com/payouts/{resource}"
        }
    },
    "curies": [
        {
            "name": "payouts",
            "href": "https://access.worldpay.com/rels/payouts/{rel}",
            "templated": true
        }
    ]
}

之后:

Copied!
{
    "outcome": "requestReceived",
    "receivedAt": "2020-05-06T12:29:39.625884Z",
    "_links": {
        "payouts:payout": {
            "href": "https://access.worldpay.com/payouts/{resource}"
        },
        "curies": [{
            "name": "payouts",
            "href": "https://access.worldpay.com/rels/payouts/{rel}",
            "templated": true
        }]
    },
    "curies": [{
        "name": "payouts",
        "href": "https://access.worldpay.com/rels/payouts/{rel}",
        "templated": true
    }]
}

查询根资源时,您现在会收到 payouts:query 操作链接。

之前:

Copied!
{
   "outcome":"payoutNotFound",
   "message":"The payout does not exist, money has not been moved. Please try the payout again."
}

之后:

Copied!
{
   "outcome":"payoutNotFound",
   "message":"Your payout request was unsuccessful. Please retry."
}

现在允许描述性文本使用以下字符:

  • abcdefghijklmnopqrstuvwxyz
  • 空格