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

管理支付

本文档概述了如何取消、结算、退款或撤销支付。

最佳实践:为了管理您的支付,建议您使用我们的活动服务在服务器上实时接收您的支付的最新状态。

取消授权

如果您不想继续支付,则可以发送取消请求。

POST 至任何您的授权响应中返回的payments:cancel操作链接,以便取消授权。

注释:您只能取消是 authorized 的支付。如果您的支付已结算,则必须创建退款

取消请求

POST https://try.access.worldpay.com/payments/authorizations/cancellations/eyJrIjoiazNhYjYzMiJ9

注释:该请求不需要请求正文。

取消响应

在响应中,您可以获得确认我们已收到了您的请求的 202 HTTP 代码。该请求在此阶段尚未处理。您必须查询支付以校验状态。 您可以在响应正文中找到该链接。

最佳实践:如果按照最佳实践使用我们的活动服务,那么您就应该了解最新的支付状态。

Copied!
{
    "_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 代码。该请求在此阶段尚未处理。您必须查询支付以校验状态。 您可以在响应正文中看到该链接,以及退款和部分退款链接。

最佳实践:如果按照最佳实践使用我们的活动服务,那么您就应该了解最新的支付状态。

Copied!
{
    "_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

Copied!
{
    "value": {
        "amount": 125,
        "currency": "GBP"
    },
    "reference": "partial-settle-reference"
}

部分结算请求参数的描述:

参数必需描述
reference由您生成的独特参考号,用于识别部分结算。有关更多信息和最佳实践,请参见交易参考号格式

部分结算响应

在响应中,您可以获得确认我们已收到了您的请求的 202 HTTP 代码。该请求在此阶段尚未处理。您必须查询支付以校验状态。 您可以在响应正文中看到该链接以及退款、部分退款部分结算以及取消您的支付的相关链接。

最佳实践:如果按照最佳实践使用我们的活动服务,那么您就应该了解最新的支付状态。

Copied!
{
    "_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 代码。该请求在此阶段尚未处理。您必须查询支付以校验状态。 您可以在响应正文中找到该链接。

最佳实践:如果按照最佳实践使用我们的活动服务,那么您就应该了解最新的支付状态。

Copied!
{
    "_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

Copied!
{
    "value": {
        "amount": 125,
        "currency": "GBP"
    },
    "reference": "partial-refund-reference"
}

部分退款响应

在响应中,您可以获得确认我们已收到了您的请求的 202 HTTP 代码。该请求在此阶段尚未处理。您必须查询支付以校验状态。 您可以在响应正文中找到该链接。

最佳实践:如果按照最佳实践使用我们的活动服务,那么您就应该了解最新的支付状态。

Copied!
{
    "_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
        }]
    }
}


撤销销售

您的撤销请求将作为取消或退款请求进行处理。这取决于您提交销售请求之后过去的时间。对于美国实体,支付会在成功提交销售请求之后一天内进行退款。任何其他支付会在 15 分钟之后移至已退款。

POST 至在migrateCardOnFileSalerecurringSale响应中收到的 payments:reversal 操作链接。

撤销请求

POST https://try.access.worldpay.com/payments/sales/reversals/eyJrIjoiazNhYjYzMiJ9

注释:该请求不需要请求正文。

撤销响应

在响应中,您可以获得确认我们已收到了您的请求的 202 HTTP 代码。该请求在此阶段尚未处理。您必须查询支付以检查其是否已取消或退款。 您可以在响应正文中找到该链接。

最佳实践:如果按照最佳实践使用我们的活动服务,那么您就应该了解最新的支付状态。

Copied!
{
    "_links": {
        "payments:events": {
            "href": "https://access.worldpay.com/payments/events/eyJrIjoiazNhYjYzMiJ9"
        },
        "curies": [
            {
                "name": "payments",
                "href": "https://access.worldpay.com/rels/payments/{rel}",
                "templated": true
            }
        ]
    }
}

后续步骤


查询支付