利用 ACH 支付
授权 ACH 支付，并利用一次调用发起结算请求。
接受销售
POST 您的请求到 direct:sale 操作链接。
销售示例请求
POST https://try.access.worldpay.com/payments/alternative/direct/sale
ACH 销售请求正文：
Copied!
{
"transactionReference": "unique-transactionReference",
"merchant": {
"entity": "an-entity"
},
"instruction": {
"narrative": {
"line1": "trading name"
},
"paymentInstrument": {
"type": "bankAccountUS",
"accountType": "checking|savings|corporate|corporateSavings",
"accountNumber": "01234567890123456",
"routingNumber": "01234567",
"checkNumber": "012345678901234",
"companyName": "for corporate accounts only",
"billingAddress": {
"firstName": "John",
"lastName": "Johnson",
"address1": "8500 Govenors Hill Drive",
"address2": "Symmes Township",
"address3": "",
"postalCode": "45249",
"city": "Ohio",
"state": "OH",
"countryCode": "US"
}
},
"value": {
"currency": "USD",
"amount": 250
}
}
}{ "transactionReference": "unique-transactionReference", "merchant": { "entity": "an-entity" }, "instruction": { "narrative": { "line1": "trading name" }, "paymentInstrument": { "type": "bankAccountUS", "accountType": "checking|savings|corporate|corporateSavings", "accountNumber": "01234567890123456", "routingNumber": "01234567", "checkNumber": "012345678901234", "companyName": "for corporate accounts only", "billingAddress": { "firstName": "John", "lastName": "Johnson", "address1": "8500 Govenors Hill Drive", "address2": "Symmes Township", "address3": "", "postalCode": "45249", "city": "Ohio", "state": "OH", "countryCode": "US" } }, "value": { "currency": "USD", "amount": 250 } } }
参数描述
| 参数 | 必需 | 描述 |
|---|---|---|
transactionReference | 该交易的独特交易参考号。最多 15 个字符，仅限数字。 | |
merchant.entity | 作为加入流程的一部分而创建，用于在 Access Worldpay 中发送销售请求。 | |
instruction | 包含与销售请求相关的所有支付信息的对象。 | |
instruction.narrative.line1 | 该字段会在客户银行对账单中显示。 | |
instruction.paymentInstrument | 包含账户详情的对象。 | |
paymentInstrument.type | 对于 ACH，支付工具类型必须为 "bankAccountUS"。 | |
paymentInstrument.accountType | 可能的值：checking、savings、corporate、corporateSavings。 | |
paymentInstrument.accountNumber | 直接转账账户的账号。 | |
paymentInstrument.routingNumber | 直接转账账户的路由代码。 | |
paymentInstrument.checkNumber | 直接转账账户的支票号码。 | |
paymentInstrument.companyName | 如果是公司账户，则为公司名称。 | |
paymentInstrument.billingAddress | 包含账单邮寄地址信息的对象。 | |
paymentInstrument.billingAddress.firstName | 所使用的 firstName 的识别码。 | |
paymentInstrument.billingAddress.lastName | 所使用的 lastName 的识别码。 | |
paymentInstrument.billingAddress.address1 | 所使用的 address1 的识别码。如果已包括，则您必须至少要发送：
| |
paymentInstrument.billingAddress.address2 | 所使用的 address2 的识别码。 | |
paymentInstrument.billingAddress.address3 | 所使用的 address3 的识别码。 | |
paymentInstrument.billingAddress.postalCode | 所使用的 postalCode 的识别码。 | |
paymentInstrument.billingAddress.city | 所使用的 city 的识别码。 | |
paymentInstrument.billingAddress.state | 所使用的 state 的识别码。 | |
paymentInstrument.billingAddress.countryCode | 所使用的 countryCode 的识别码。 | |
instruction.value | 包含销售值的对象。 | |
instruction.value.currency | 所使用的 currency 的识别码。 | |
instruction.value.amount | 所使用的 amount 的识别码。 |
销售响应
最佳实践：Access Worldpay 在服务响应的头文件中返回 WP-CorrelationId。我们强烈建议您将此记录下来。我们使用 WP-CorrelationId 来检查个性化服务请求。
成功支付
您会接收到：
已拒绝的支付
您会接收到：
- HTTP 代码
201 - 一个
"outcome": "refused"
Copied!
{
"outcome": "sentForSettlement",
"_links": {
"direct:events": {
"href": "https://try.access.worldpay.com/payments/alternative/direct/events/linkData"
},
"direct:reversal": {
"href": "https://try.access.worldpay.com/payments/alternative/direct/reversals/linkData"
},
"curies": [{
"name": "direct",
"href": "https://try.access.worldpay.com/rels/payments/alternative/direct/{rels}",
"templated": true
}]
}
}{ "outcome": "sentForSettlement", "_links": { "direct:events": { "href": "https://try.access.worldpay.com/payments/alternative/direct/events/linkData" }, "direct:reversal": { "href": "https://try.access.worldpay.com/payments/alternative/direct/reversals/linkData" }, "curies": [{ "name": "direct", "href": "https://try.access.worldpay.com/rels/payments/alternative/direct/{rels}", "templated": true }] } }
{
"outcome": "refused",
"_links": {
"direct:events": {
"href": "https://try.access.worldpay.com/payments/alternative/direct/events/{linkData}"
},
"curies": [{
"name": "direct",
"href": "https://try.access.worldpay.com/rels/payments/alternative/direct/{rel}",
"templated": true
}]
}
}{ "outcome": "refused", "_links": { "direct:events": { "href": "https://try.access.worldpay.com/payments/alternative/direct/events/{linkData}" }, "curies": [{ "name": "direct", "href": "https://try.access.worldpay.com/rels/payments/alternative/direct/{rel}", "templated": true }] } }
注释：如果出现错误，您可以在我们的
后续步骤
