接受重复性授权

在使用您的客户存储的卡详情发起支付时，您可以使用我们的重复性授权资源。接受付款时首先验证或不验证您客户的账户。请在此处阅读有关员工重复性规定的更多详情。

什么是重复性支付？

在您的客户在授权点未主动参与时由流程触发的交易
只能在您的客户通过身份验证并同意一项委付款项时作为原始预存卡号的后续予以执行
您必须声明所有重复性支付的用途，包括订阅、分期或计划外
有时也被称为商户发起的交易 (MIT)

在此页面上：

重复性授权且需要验证

验证您客户的账户，然后再提交您的第一次重复性支付以便进行授权。

重复性支付请求

POST 您发至在成功的cardOnFile 智能或dynamicCardOnFile验证中收到的payments:recurringAuthorize操作链接中的支付请求。

示例请求

POST http://try.access.worldpay.com/payments/authorizations/recurring/{resource}

单击下表以查看全部支持的 paymentInstrument 参数的必需字段。

请求正文

Copied!

{
    "transactionReference": "Memory265-13/08/1876",
    "merchant": {
        "entity": "MindPalaceLtd"
    },
    "instruction": {
        "narrative": {
            "line1": "trading name"
        },
        "paymentInstrument": {
            "type": "card/plain",
            "cardNumber": "4444333322221111",
            "cardExpiryDate": {
                "month": 12,
                "year": 2020
            }
        },
        "value": {
            "currency": "GBP",
            "amount": 250
        },
        "intent": "subscription"
    }
}

{
    "transactionReference": "Memory265-13/08/1876",
    "merchant": {
        "entity": "MindPalaceLtd"
    },
    "instruction": {
        "narrative": {
            "line1": "Mind Palace Ltd"
        },
        "value": {
            "currency": "GBP",
            "amount": 250
        },
        "paymentInstrument": {
            "type": "card/token",
            "href": "https://try.access.worldpay.com/tokens/{}"
        },
        "intent": "unscheduled"
    }
}

参数描述

参数	必需	描述
`transactionReference`		由您生成的独特参考号，用于在支付的整个生命周期中对其进行识别。请参见交易参考格式，了解更多详情和最佳实践。
`merchant`		包含有关商户信息的对象。
`merchant.entity`		确定您支付的方向，以协助开单、报告和对账。这对于身份验证和查询为必需。请联系您的实施经理了解更多详情。
`instruction.intent`		详细说明此具体重复性协议原因的参数。有效用途： `subscription` `unscheduled` `instalment`
`instruction`		包含与支付相关的所有信息的对象。
`instruction.narrative`		出现在您的客户对账单上的文本。用于识别商户。请参见商户落款格式，了解更多详情和最佳实践。
`narrative.line1`		出现在您客户的对账单上的叙述文字的第一行（最多 24 个字符。如果不支持某个字符，则以空格代替）。请参见商户落款`line1`格式，了解更多详情。
`instruction.value`		包含有关支付值信息的对象。
`value.currency`		3 位数货币代码。请参见支持的货币列表。
`value.amount`		支付金额。这是一个包含小数位的整数，e.g.，如果小数位是二，则 250 就表示 2.50.您可以在我们的货币表中查找相关小数位。
`instruction.paymentInstrument`		包含支付类型和详情的对象。若要将 Token 作为 `paymentInstrument` 使用，您必须首先创建 Token，请参见我们有关如何创建 Token 的Tokens API。
`payoutInstrument.cardExpiryDate`		包含您的客户卡过期日期的对象。对所有 `"type": "card/plain"` 请求为必需。
`payoutInstrument.cardNumber`		包含您的客户卡号的对象。对 `"type": "card/plain"` 请求为必需。

可选参数

参数	必需	描述
`narrative.line2`		有关支付的其他详情，e.g.订单号、电话号码。
`instruction.debtRepayment`		DRI 是为偿还债务而标记某项支付的标志。可能的值： `true`（仅在 true 时提供）如需更多信息，请联系您的客户关系经理。
`payoutInstrument.cardHolderName`		包含您客户卡名称的对象。这不是必需字段，但建议您提供相关信息以提高授权率。如未发送，则默认值为 "Not Supplied"（未提供）。
`paymentInstrument.billingAddress`		包含账单邮寄地址信息的对象。如果已包括，则您必须至少要发送：`address1` `city` `countryCode` `postalCode` 此项用于地址验证服务 (AVS) 且只能随 `card/plain` 支付工具提供。我们的 API 会检查所提交的 AVS，以核实其是否与发卡银行注册的地址相符。如果所提供的地址与注册的地址不符，则意味着该支付存在其他风险。
`merchant.mcc`		您可以将商户类别代码 (`mcc`) 应用于单个请求。如果在加入过程中启用了动态 MCC（商户类别代码），则您只能提供 `mcc`。如果此功能已启用但未提供，则 `merchant.mcc` 会默认为已配置的值。如需更多信息，请联系您的客户关系经理。
`paymentInstrument.cvc`		CVC 是卡背面上的一组 3 或 4 个数字的独特号码。我们的 API 会检查所提供的 CVC 是否与发卡银行留存的 CVC 匹配。
`merchant.paymentFacilitator`		包含您的支付服务商信息的对象。如果为必需，则您必须发送： `pfId` `isoId` `subMerchant.merchantId` `subMerchant.postalcode` `subMerchant.street` `subMerchant.city` `subMerchant.countryCode` 只有您是支付服务商时，该信息在每个重复性请求中才是必需的。您可以在此处了解信息。

以下请求包含成功的重复性支付请求所需的所有必需和可选字段。完整请求架构也可在我们的API 参考中查阅。

完整重复性支付请求正文

Copied!

{
    "transactionReference": "Memory265-13/08/1876",
    "merchant": {
        "entity": "MindPalaceLtd",
        "mcc": "6432",
        "paymentFacilitator": {
            "pfId": "12345",
            "isoId": "12345",
            "subMerchant": {
                "name": "John",
                "merchantId": "12345",
                "postalCode": "SW1 1AA",
                "street": "Regent Street",
                "city": "London",
                "state": "WSM",
                "countryCode": "826",
                "taxId": "ABC-123456789",
                "email": "test@email.com",
                "telephone": "+447987 654321"
            }
        }
    },
    "instruction": {
        "narrative": {
            "line1": "Mind Palace Ltd",
            "line2": "Memory265-13/08/1876"
        },
        "scheme": {
            "reference": "28379213"
        },
        "value": {
            "currency": "GBP",
            "amount": 250
        },
        "paymentInstrument": {
            "billingAddress": {
                "address1": "221B Baker Street",
                "address2": "Marylebone",
                "address3": "Westminster",
                "postalCode": "NW1 6XE",
                "city": "London",
                "state": "Greater London",
                "countryCode": "GB"
            },
            "type": "card/plain",
            "cardHolderName": "Sherlock Holmes",
            "cardNumber": "4444333322221111",
            "cardExpiryDate": {
                "month": 12,
                "year": 2020
            }
        },
        "intent": "instalment"
    }
}

{
    "transactionReference": "Memory265-13/08/1876",
    "merchant": {
        "entity": "MindPalaceLtd",
        "mcc": "1000",
        "paymentFacilitator": {
            "pfId": "12345",
            "isoId": "12345",
            "subMerchant": {
                "name": "John",
                "merchantId": "12345",
                "postalCode": "SW1 1AA",
                "street": "Regent Street",
                "city": "London",
                "state": "WSM",
                "countryCode": "826",
                "taxId": "ABC-123456789",
                "email": "test@email.com",
                "telephone": "+447987 654321"
            }
        }
    },
    "instruction": {
        "narrative": {
            "line1": "Mind Palace Ltd",
            "line2": "Memory265-13/08/1876"
        },
        "value": {
            "currency": "GBP",
            "amount": 250
        },
        "paymentInstrument": {
            "type": "card/token",
            "href": "https://try.access.worldpay.com/tokens/{}"

        },
        "intent": "unscheduled"
    }
}

响应

最佳实践：Access Worldpay 在服务响应的头文件中返回WP-CorrelationId。我们强烈建议您将此记录下来。我们使用WP-CorrelationId检查单个服务请求。

成功支付

HTTP 代码 201
"outcome": "authorized"
风险因素（仅在发卡机构发现冲突时才返回）
发卡机构授权代码
方案参考号（由主要银行卡方案支持，但可能不会为所有的方案/地区返回）
取消、结算、部分结算或跟踪支付事件的链接
在您的重复支付协议中的下次支付时使用的授权链接

已拒绝的支付

您会接收到：

HTTP 代码 201
"outcome": "refused"
拒绝代码
为拒绝提供更多上下文的 description
风险因素（仅在发卡机构发现冲突时才返回）

示例响应

Copied!

{
    "outcome": "authorized",
    "riskFactors": [{
            "risk": "not_matched",
            "type": "cvc"
        },
        {
            "risk": "not_checked",
            "detail": "postcode",
            "type": "avs"
        },
        {
            "risk": "not_checked",
            "detail": "address",
            "type": "avs"
        }
    ],
    "issuer": {
        "authorizationCode": "0"
    },
    "scheme": {
        "reference": "1260019172"
    },
    "_links": {
        "payments:cancel": {
            "href": "https://try.access.worldpay.com/payments/authorizations/cancellations/eyJrIjoiazNhYjYzMiJ9"
        },
        "payments:settle": {
            "href": "https://try.access.worldpay.com/payments/settlements/full/eyJrIjoiazNhYjYzMiJ9"
        },
        "payments:partialSettle": {
            "href": "https://try.access.worldpay.com/payments/settlements/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
        }],
        "payments:recurringAuthorize": {
            "href": "https://try.access.worldpay.com/payments/authorizations/recurring/eyJrIjoiazNhYjYzMiJ9"
        }
    }
}

{
    "outcome": "refused",
    "description": "CARD EXPIRED",
    "code": "33",
    "refusalAdvice": {
        "code": "01"
    },
    "riskFactors": [{
            "risk": "not_supplied",
            "type": "cvc"
        },
        {
            "risk": "not_checked",
            "detail": "address",
            "type": "avs"
        },
        {
            "risk": "not_checked",
            "detail": "postcode",
            "type": "avs"
        },
        {
            "risk": "verificationFailed",
            "type": "riskProfile"
        }
    ]
}

您必须总是存储和使用payments:recurringAuthorize操作链接中返回的链接，以授权您的下一次重复性支付。

注释：如果出现错误，您可以在我们的错误参考中获取更多信息。

后续步骤

支付退款

重复性授权且无需验证

在使用您的客户存储的卡详情发起支付无需首先验证客户账户时，您可以使用我们的迁移重复性授权资源。

重复性支付请求

POST 您的重复性授权请求至[payments:migrateRecurringAuthorize]我们在您的查询支付根资源请求中收到的 (/zh/docs/access-worldpay/api/references/payments/migraterecurringauthorizations) 操作链接。

`migrateRecurring` 授权示例请求

POST https://try.access.worldpay.com/payments/authorizations/migrateRecurring

单击下表以查看全部支持的 paymentInstrument 参数的所有必需字段。

migrateRecurring 授权请求正文：

Copied!

{
    "transactionReference": "Memory265-13/08/1876",
    "merchant": {
        "entity": "MindPalaceLtd"
    },
    "instruction": {
        "narrative": {
            "line1": "trading name"
        },
        "paymentInstrument": {
            "type": "card/plain",
            "cardNumber": "4444333322221111",
            "cardExpiryDate": {
                "month": 12,
                "year": 2020
            }
        },
        "value": {
            "currency": "GBP",
            "amount": 250
        },
        "intent": "subscription"
    }
}

{
    "transactionReference": "Memory265-13/08/1876",
    "merchant": {
        "entity": "MindPalaceLtd"
    },
    "instruction": {
        "narrative": {
            "line1": "Mind Palace Ltd"
        },
        "value": {
            "currency": "GBP",
            "amount": 250
        },
        "paymentInstrument": {
            "type": "card/token",
            "href": "https://try.access.worldpay.com/tokens/{}"
        },
        "intent": "unscheduled"
    }
}

{
    "transactionReference": "Memory265-13/08/1876",
    "merchant": {
        "entity": "MindPalaceLtd"
    },
    "instruction": {
        "intent":"instalment",
        "narrative": {
            "line1": "Mind Palace Ltd"
        },
        "value": {
            "currency": "GBP",
            "amount": 250
        },
        "paymentInstrument": {
            "type": "card/networkToken+applepay",
            "dpan": "4444333322221111",
            "cardExpiryDate": {
                "month": 5,
                "year": 2035
            }
        }
    }
}

参数描述

参数	描述
`instruction.paymentInstrument`	包含支付类型和详情的对象。将 `card/networkToken+applepay` 用于解码的钱包流。`paymentInstrument` 中包括 `dpan`，可替代原始卡号。它由卡网络/钱包提供商生成。

您可以在此处了解完整的参数描述。

可选参数

以下请求包含成功的 migrateRecurring 授权请求所需的所有必需和可选字段。完整请求架构也可在我们的API 参考中查阅。

完整 `migrateRecurring` 授权请求架构

完整 migrateRecurring 授权请求正文：

Copied!

{
    "transactionReference": "Memory265-13/08/1876",
    "merchant": {
        "entity": "MindPalaceLtd",
        "mcc": "6432",
        "paymentFacilitator": {
            "pfId": "12345",
            "isoId": "12345",
            "subMerchant": {
                "name": "John",
                "merchantId": "12345",
                "postalCode": "SW1 1AA",
                "street": "Regent Street",
                "city": "London",
                "state": "WSM",
                "countryCode": "826",
                "taxId": "ABC-123456789",
                "email": "test@email.com",
                "telephone": "+447987 654321"
            }
        }
    },
    "instruction": {
        "narrative": {
            "line1": "Mind Palace Ltd",
            "line2": "Memory265-13/08/1876"
        },
        "scheme": {
            "reference": "28379213"
        },
        "value": {
            "currency": "GBP",
            "amount": 250
        },
        "paymentInstrument": {
            "billingAddress": {
                "address1": "221B Baker Street",
                "address2": "Marylebone",
                "address3": "Westminster",
                "postalCode": "NW1 6XE",
                "city": "London",
                "state": "Greater London",
                "countryCode": "GB"
            },
            "type": "card/plain",
            "cardHolderName": "Sherlock Holmes",
            "cardNumber": "4444333322221111",
            "cardExpiryDate": {
                "month": 12,
                "year": 2020
            }
        },
        "intent": "instalment"
    }
}

{
    "transactionReference": "Memory265-13/08/1876",
    "merchant": {
        "entity": "MindPalaceLtd",
        "mcc": "1000",
        "paymentFacilitator": {
            "pfId": "12345",
            "isoId": "12345",
            "subMerchant": {
                "name": "John",
                "merchantId": "12345",
                "postalCode": "SW1 1AA",
                "street": "Regent Street",
                "city": "London",
                "state": "WSM",
                "countryCode": "826",
                "taxId": "ABC-123456789",
                "email": "test@email.com",
                "telephone": "+447987 654321"
            }
        }
    },
    "instruction": {
        "narrative": {
            "line1": "Mind Palace Ltd",
            "line2": "Memory265-13/08/1876"
        },
        "value": {
            "currency": "GBP",
            "amount": 250
        },
        "paymentInstrument": {
            "type": "card/token",
            "href": "https://try.access.worldpay.com/tokens/{}"

        },
        "intent": "unscheduled"
    }
}

{
    "transactionReference": "Memory265-13/08/1876",
    "merchant": {
        "entity": "MindPalaceLtd",
        "mcc": "6432",
        "paymentFacilitator": {
            "pfId": "12345",
            "isoId": "12345",
            "subMerchant": {
                "name": "John",
                "merchantId": "12345",
                "postalCode": "SW1 1AA",
                "street": "Regent Street",
                "city": "London",
                "state": "WSM",
                "countryCode": "826",
                "taxId": "ABC-123456789",
                "email": "test@email.com",
                "telephone": "+447987 654321"
            }
        }
    },
    "instruction": {
        "intent":"instalment",
        "scheme": {
            "reference": "0123456"
        },
        "narrative": {
            "line1": "Mind Palace Ltd",
            "line2": "Memory265-13/08/1876"
        },
        "value": {
            "currency": "GBP",
            "amount": 250
        },
        "paymentInstrument": {
            "type": "card/networkToken+applepay",
            "dpan": "4444333322221111",
            "billingAddress": {
                "address1": "221B Baker Street",
                "address2": "Marylebone",
                "address3": "Westminster",
                "postalCode": "NW1 6XE",
                "city": "London",
                "state": "Greater London",
                "countryCode": "GB"
            },
            "cardHolderName": "Sherlock Holmes",
            "cardExpiryDate": {
                "month": 12,
                "year": 2020
            }
        }
    }
}

可选参数描述

参数	描述
`scheme.reference`	由方案提供的独特参考号，以识别您与客户之间达成的重复支付协议。协议中的每笔后续支付都会生成一个新的参考号。您只能为 `card/plain` 请求提交该信息。大部分但并非所有发卡机构都会返回此信息。

`migrateRecurring` 授权响应

最佳实践：Access Worldpay 在服务响应的头文件中返回WP-CorrelationId。我们强烈建议您将此记录下来。我们使用WP-CorrelationId检查单个服务请求。

成功支付

HTTP 代码 201
"outcome": "authorized"
风险因素（仅在发卡机构发现冲突时才返回）
发卡机构授权代码
方案参考号（由主要银行卡方案支持，但可能不会为所有的方案/地区返回）
paymentInstrument（仅用于 Apple Pay 解码）
取消、结算、部分结算或跟踪支付事件的链接
在您的重复支付协议中的下次支付时使用的授权链接

已拒绝的支付

您会接收到：

HTTP 代码 201
"outcome": "refused"
拒绝代码
为拒绝提供更多上下文的 description
风险因素（仅在发卡机构发现冲突时才返回）

示例响应

Copied!

{
    "outcome": "authorized",
    "riskFactors": [{
            "risk": "not_matched",
            "type": "cvc"
        },
        {
            "risk": "not_checked",
            "detail": "postcode",
            "type": "avs"
        },
        {
            "risk": "not_checked",
            "detail": "address",
            "type": "avs"
        }
    ],
    "issuer": {
        "authorizationCode": "0"
    },
    "scheme": {
        "reference": "1260019172"
    },
    "_links": {
        "payments:cancel": {
            "href": "https://try.access.worldpay.com/payments/authorizations/cancellations/eyJrIjoiazNhYjYzMiJ9"
        },
        "payments:settle": {
            "href": "https://try.access.worldpay.com/payments/settlements/full/eyJrIjoiazNhYjYzMiJ9"
        },
        "payments:partialSettle": {
            "href": "https://try.access.worldpay.com/payments/settlements/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
        }],
        "payments:recurringAuthorize": {
            "href": "https://try.access.worldpay.com/payments/authorizations/recurring/eyJrIjoiazNhYjYzMiJ9"
        }
    }
}

{
    "outcome": "authorized",
    "riskFactors": [{
            "risk": "not_checked",
            "detail": "address",
            "type": "avs"
        },
        {
            "risk": "not_checked",
            "detail": "postcode",
            "type": "avs"
        }
    ],
    "scheme": {
        "reference": "000000000000020005060720116005061"
    },
    "paymentInstrument": {
        "type": "card/network",
        "card": {
            "paymentAccountReference": "Q1HJZ28RKA1EBL470G9XYG90R5D3E"
        }
    },
    "_links": {
        "payments:cancel": {
            "href": "https://try.access.worldpay.com/payments/authorizations/cancellations/eyJrIjoiazNhYjYzMiIsImxpbmtWZ"
        },
        "payments:settle": {
            "href": "https://try.access.worldpay.com/payments/settlements/full/eyJrIjoiazNhYjYzMiIsImxpbmtWZXJ"
        },
        "payments:partialSettle": {
            "href": "https://try.access.worldpay.com/payments/settlements/partials/eyJrI"
        },
        "payments:events": {
            "href": "https://try.access.worldpay.com/payments/events/eyJrIjoiazNhYjYzMiI"
        },
        "curies": [
            {
                "name": "payments",
                "href": "https://try.access.worldpay.com/rels/payments/{rel}",
                "templated": true
            }
        ],
        "payments:recurringAuthorize": {
            "href": "https://try.access.worldpay.com/payments/authorizations/recurring/eyJrIjoiazNhYjYzMiIsImxpbmtWZXJ"
        }
    }
}

{
    "outcome": "refused",
    "description": "CARD EXPIRED",
    "code": "33",
    "refusalAdvice": {
        "code": "01"
    },
    "riskFactors": [{
            "risk": "not_supplied",
            "type": "cvc"
        },
        {
            "risk": "not_checked",
            "detail": "address",
            "type": "avs"
        },
        {
            "risk": "not_checked",
            "detail": "postcode",
            "type": "avs"
        },
        {
            "risk": "verificationFailed",
            "type": "riskProfile"
        }
    ]
}

您可以使用payments:settle操作链接来立即结算支付。您还可以将响应进行缓存，并在以后再使用该链接来结算支付。

您必须总是存储和使用payments:migrateRecurringAuthorize操作链接中返回的链接，以授权您的下一次重复性支付。

注释：如果出现错误，您可以在我们的错误参考中获取更多信息。

后续步骤

结算或取消支付

Translation disclaimer

Searching accross the entire site

Filter by product

Filter by product Searching across the entire site

Translation disclaimer Collapse

接受重复性授权

什么是重复性支付？

在此页面上：

重复性授权且需要验证

重复性支付请求

示例请求

请求正文

参数描述

可选参数

响应

成功支付

已拒绝的支付

示例响应

重复性授权且无需验证

重复性支付请求

migrateRecurring 授权示例请求

参数描述

可选参数

完整 migrateRecurring 授权请求架构

可选参数描述

migrateRecurring 授权响应

成功支付

已拒绝的支付

示例响应

Searching accross the entire site

Filter by product

Filter by product Searching across the entire site

​

Translation disclaimer

`migrateRecurring` 授权示例请求

完整 `migrateRecurring` 授权请求架构

`migrateRecurring` 授权响应