管理支付
本文档概述了如何取消、结算、退款或撤销支付。
最佳实践:为了管理您的支付,建议您使用我们的
取消授权
如果您不想继续支付,则可以发送取消请求。
POST 至任何您的授权响应中返回的payments:cancel
注释:您只能取消是 authorized
的支付。如果您的支付已结算,则必须创建
取消请求
POST https://try.access.worldpay.com/payments/authorizations/cancellations/eyJrIjoiazNhYjYzMiJ9
注释:该请求不需要请求正文。
取消响应
在响应中,您可以获得确认我们已收到了您的请求的 202
HTTP 代码。该请求在此阶段尚未处理。您必须
最佳实践:如果按照最佳实践使用我们的
{
"_links": {
"payments:events": {
"href": "https://try.access.worldpay.com/payments/events/eyJrIjoiazNhYjYzMiJ9"
},
"curies": [
{
"name": "payments",
"href": "https://try.access.worldpay.com/rels/payments/{rel}",
"templated": true
}
]
}
}
结算授权
若要接收客户发来的所有资金,请向我们发送结算请求。
POST 至任何您授权响应中返回的payments:settle
结算请求
POST https://try.access.worldpay.com/payments/settlements/full/eyJrIjoiazNhYjYzMiJ9
注释:该请求不需要请求正文。
在您提出结算请求时,支付活动会变成 sentForSettlement
。
结算响应
在响应中,您可以获得确认我们已收到了您的请求的 202
HTTP 代码。该请求在此阶段尚未处理。您必须
最佳实践:如果按照最佳实践使用我们的
{
"_links": {
"payments:refund": {
"href": "https://try.access.worldpay.com/payments/settlements/refunds/full/eyJrIjoiazNhYjYzMiJ9"
},
"payments:partialRefund": {
"href": "https://try.access.worldpay.com/payments/settlements/refunds/partials/eyJrIjoiazNhYjYzMiJ9"
},
"payments:events": {
"href": "https://try.access.worldpay.com/payments/events/eyJrIjoiazNhYjYzMiJ9"
},
"curies": [
{
"name": "payments",
"href": "https://try.access.worldpay.com/rels/payments/{rel}",
"templated": true
}
]
}
}
部分结算授权
若要接收部分支付资金,可向我们发送部分结算请求。
POST 至您payments:partialSettle
注释:我们不验证货币和金额是否与原始支付相同。
部分结算请求
POST https://try.access.worldpay.com/payments/settlements/partials/eyJrIjoiazNhYjYzMiJ9
{
"value": {
"amount": 125,
"currency": "GBP"
},
"reference": "partial-settle-reference"
}
部分结算请求参数的描述:
参数 | 必需 | 描述 |
---|---|---|
reference | 由您生成的独特参考号,用于识别部分结算。有关更多信息和最佳实践,请参见 |
部分结算响应
在响应中,您可以获得确认我们已收到了您的请求的 202
HTTP 代码。该请求在此阶段尚未处理。您必须
最佳实践:如果按照最佳实践使用我们的
{
"_links": {
"payments:refund": {
"href": "https://try.access.worldpay.com/payments/settlements/refunds/full/eyJrIjoiazNhYjYzMiJ9"
},
"payments:partialRefund": {
"href": "https://try.access.worldpay.com/payments/settlements/refunds/partials/eyJrIjoiazNhYjYzMiJ9"
},
"payments:partialSettle": {
"href": "https://try.access.worldpay.com/payments/settlements/partials/eyJrIjoiazNhYjYzMiJ9"
},
"payments:cancel": {
"href": "https://try.access.worldpay.com/payments/authorizations/cancellations/eyJrIjoiazNhYjYzMiJ9"
},
"payments:events": {
"href": "https://try.access.worldpay.com/payments/events/eyJrIjoiazNhYjYzMiJ9"
},
"curies": [{
"name": "payments",
"href": "https://try.access.worldpay.com/rels/payments/{rel}",
"templated": true
}]
}
}
支付全部退款
发送退款请求,以便向您的客户返还全部settled
金额。
POST
至您payments:refund
操作链接。
全部退款请求
POST https://try.access.worldpay.com/payments/settlements/refunds/full/eyJrIjoiazNhYjYzMiJ9
注释:该请求不需要请求正文。
全部退款响应
在响应中,您可以获得确认我们已收到了您的请求的 202
HTTP 代码。该请求在此阶段尚未处理。您必须
最佳实践:如果按照最佳实践使用我们的
{
"_links": {
"payments:events": {
"href": "https://access.worldpay.com/payments/events/eyJrIjoiazNhYjYzMiJ9"
},
"curies": [
{
"name": "payments",
"href": "https://access.worldpay.com/rels/payments/{rel}",
"templated": true
}
]
}
}
支付部分退款
发送部分退款请求,以便向您的客户返还部分settled
金额。
POST
至您的payments:partialRefund
操作链接。
部分退款请求
在正文中发送要退款的 amount
和授权 currency
。
POST https://try.access.worldpay.com/payments/settlements/refunds/partials/eyJrIjoiazNhYjYzMiJ9
{
"value": {
"amount": 125,
"currency": "GBP"
},
"reference": "partial-refund-reference"
}
部分退款响应
在响应中,您可以获得确认我们已收到了您的请求的 202
HTTP 代码。该请求在此阶段尚未处理。您必须
最佳实践:如果按照最佳实践使用我们的
{
"_links": {
"payments:partialRefund": {
"href": "https://try.access.worldpay.com/payments/settlements/refunds/partials/eyJrIjoiazNhYjYzMiJ9"
},
"payments:events": {
"href": "https://try.access.worldpay.com/payments/events/eyJrIjoiazNhYjYzMiJ9"
},
"curies": [{
"name": "payments",
"href": "https://try.access.worldpay.com/rels/payments/{rel}",
"templated": true
}]
}
}
撤销销售
您的撤销请求将作为取消或退款请求进行处理。这取决于您提交
POST
至在payments:reversal
操作链接。
撤销请求
POST https://try.access.worldpay.com/payments/sales/reversals/eyJrIjoiazNhYjYzMiJ9
注释:该请求不需要请求正文。
撤销响应
在响应中,您可以获得确认我们已收到了您的请求的 202
HTTP 代码。该请求在此阶段尚未处理。您必须
最佳实践:如果按照最佳实践使用我们的
{
"_links": {
"payments:events": {
"href": "https://access.worldpay.com/payments/events/eyJrIjoiazNhYjYzMiJ9"
},
"curies": [
{
"name": "payments",
"href": "https://access.worldpay.com/rels/payments/{rel}",
"templated": true
}
]
}
}
后续步骤