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

接受重复性销售

在使用客户存储的卡详情发起支付并向即时触发结算流程时,可以使用我们的重复性销售资源。 请在此处阅读有关员工重复性规定的更多详情。

什么是重复性支付?

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

前提条件

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

重复性销售

如果您存储了卡详情,则可以使用我们的重复性销售资源来授权和结算商户发起的交易。

POST 您发至在成功的cardOnFile 智能dynamicCardOnFile验证中收到的 payments:recurringSale 操作链接中的重复性销售请求。

重复性销售示例请求

POST https://try.access.worldpay.com/payments/sales/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确定您支付的方向,以协助开单、报告和对账。这对于身份验证和查询为必需。
请联系您的实施经理了解更多详情。
merchant.mcc您可以将商户类别代码 (mcc) 应用于单个请求。如果在加入过程中启用了动态 MCC(商户类别代码),则您只能提供 mcc。如果此功能已启用但未提供,则 merchant.mcc 会默认为已配置的值。如需更多信息,请联系您的客户关系经理
merchant.paymentFacilitator包含您的支付服务商信息的对象。如果为必需,则您必须发送
  • pfId
  • isoId
  • subMerchant.merchantId
  • subMerchant.postalcode
  • subMerchant.street
  • subMerchant.city
  • subMerchant.countryCode
  • subMerchant.telephone(Amex 必需)
  • subMerchant.email(Amex 必需)
只有您是支付服务商时,该信息在每个销售请求中才是必需的。您可以在此处了解更多格式化信息。
instruction包含与支付相关的所有信息的对象。
instruction.intent详细说明此具体重复性协议原因的参数。有效用途:
  • subscription
  • unscheduled
  • instalment
instruction.narrative出现在您的客户对账单上的文本。用于识别商户。
请参见商户落款格式,了解更多详情和最佳实践。
narrative.line1出现在您客户的对账单上的叙述文字的第一行(最多 24 个字符。如果不支持某个字符,则以空格代替)。
请参见商户落款line1格式,了解更多详情。
narrative.line2有关支付的其他详情,e.g.订单号、电话号码。
instruction.value包含有关支付值信息的对象。
value.currency3 位数货币代码。
请参见支持的货币列表。
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" 请求为必需。
paymentInstrument.cvcCVC 是卡背面上的一组 3 或 4 个数字的独特号码。我们的 API 会检查所提供的 CVC 是否与发卡银行留存的 CVC 匹配。
paymentInstrument.cardHolderName包含您客户卡名称的对象。
这不是必需字段,但建议您提供相关信息以提高授权率。如未发送,则默认值为 "Not Supplied"(未提供)。
paymentInstrument.billingAddress包含账单邮寄地址信息的对象。如果已包括,则您必须至少
  • 要发送:address1
  • city
  • countryCode
  • postalCode
此项用于地址验证服务 (AVS) 且只能随 card/plain 支付工具提供。我们的 API 会检查所提交的 AVS,以核实其是否与发卡银行注册的地址相符。如果所提供的地址与注册的地址不符,则意味着该支付存在其他风险。
instruction.debtRepaymentDRI 是为偿还债务而标记某项支付的标志。可能的值:
  • true(仅在 true 时提供)
如需更多信息,请联系您的客户关系经理

可选参数

重复性销售响应

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

成功响应

  • HTTP 代码 201
  • AN "outcome": "Sent for Settlement"
  • 风险因素(仅在发卡机构发现冲突时才返回)
  • 发卡机构授权代码
  • 方案参考号(由主要银行卡方案支持,但可能不会为所有的方案/地区返回)
  • 退款部分退款撤销或[跟踪支付活动]的链接(zh/docs/access-worldpay/payments/track-a-payment)
  • 在您的重复支付协议中的下次支付时使用的授权链接

拒绝的响应

您会接收到:

  • HTTP 代码 201
  • AN "outcome": "refused"
  • 拒绝代码
  • 为拒绝提供更多上下文的 description
  • 拒绝建议代码(仅当由银行卡方案和收单机构返回时)
  • 风险因素(仅在发卡机构发现冲突时才返回)

示例响应

Copied!
{
    "outcome": "Sent for Settlement",
    "issuer": {
        "authorizationCode": "12345A"
    },
    "scheme": {
        "reference": "1260019172"
    },
    "paymentInstrument": {
        "type": "card/plain+masked",
        "card": {
            "brand": "visa",
            "number": {
                "bin": "444433",
                "last4Digits": "1111"
            },
            "expiryDate": {
                "month": 12,
                "year": 2025
            },
            "fundingType": "credit",
            "category": "consumer",
            "issuer": {
                "name": "Some Issuer PLC"
            },
            "paymentAccountReference": "ABC123DEF456GHI789JKL123M"
        }
    },
    "riskFactors": [{
            "risk": "not_matched",
            "type": "cvc"
        },
        {
            "risk": "not_checked",
            "detail": "postcode",
            "type": "avs"
        },
        {
            "risk": "not_checked",
            "detail": "address",
            "type": "avs"
        }
    ],
    "_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:reversal": {
            "href": "https://try.access.worldpay.com/payments/sales/reversals/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:recurringSale": {
            "href": "https://try.access.worldpay.com/payments/sales/recurring/eyJrIjoiazNhYjYzMiJ9"
        }
    }
}
{
    "outcome": "refused",
    "description": "RESTRICTED CARD",
    "code": "62",
    "rawCode": "62",
    "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:recurringSale 操作链接中返回的链接,以用于您的后续重复性销售请求。

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


后续步骤


支付退款