管理api
构建应用程序
快速启动
指南
教程
建立渠道
快速启动
指南
教程
建筑店面
管理货币
指南
合作伙伴信息
成为合作伙伴
开始
POS解决方案
ERP解决方案
PIM解决方案
OMS解决方案
营销解决方案
运输解决方案
支付解决方案

付款API.

付款API使您可以通过商店的已连接支付网关进行付款。商家可以收到使用的订单付款服务器到服务器的签出API订单端点或V2订单端点。

使用对两个API主机的请求序列处理付款:

  • 创建支付令牌:https://api.bigcommerce.com/stores/{store_hash►}/v3/payments/access_tokens.
  • 处理付款:https://payments.bigcommerce.com/stores/ {store_hash} /支付

必需的OAuth范围

  • 创建付款
  • 收到你的付款方法

运行在邮递员

PCI遵从性

BigCommerce只在支付从支付请求到支付处理程序的过程中维护安全处理的情况下对信用卡的安全负责。作为第三方开发人员,您负责以一种PCI兼容的方式开发店面或重复计费应用程序。您还需要维护由外部合格安全评估员(QSA)认证的第三方服务提供商的PCI遵从性认证。

重复使用BigCommerce支付API的计费应用程序收集的商家或购物者的个人身份信息(PII)必须有自己的隐私政策,足以满足欧盟通用数据保护要求(GDPR)的要求。GDPR必须是可用的,并向一般公众显示。

PCI遵从性

如果您的应用程序处理信用卡数据,您需要符合PCI。SAQs(自我评估问卷)可以提交给compliance@bigcommerce.com

处理付款

您可以使用存储在BigCommerce存储信用卡功能中的信用卡或提供信用卡号来处理支付。

BigCommerce支持以下存储卡网关:

  • AdyenV2
  • Authorize.net
  • 巴克莱卡融合
  • 螺栓
  • Checkout.com
  • CyberSource
  • MyVirtualMerchant
  • Paymetric
  • 贝宝是由Braintree开发的
  • 条纹
  • StripeV3

BigCommerce支持以下信用卡网关:

  • AdyenV2
  • Authorize.net
  • 巴克莱卡融合
  • 螺栓
  • CardConnect
  • 追逐综合付款
  • 追逐商业服务
  • Checkout.com
  • Cybersource
  • eWAY快速
  • 第一数据payeezy网关
  • 哈特兰支付系统
  • MyVirtualMerchant
  • 敝中断
  • 轨道
  • Paymetric
  • 贝宝是由Braintree开发的
  • PayPal支付专业版(Payflow Edition)英国
  • PayPal Payments Pro (Payflow Edition)美国
  • QuickBooks付款
  • Sage Pay / Protx VSP直接
  • Securenet.
  • 条纹
  • StripeV3
  • 美国环田
  • Vantiv
  • Vantiv核心
  • Windcave
  • Worldpay核心
  • WorldPay

如果提供商要求3DS认证,试图通过使用完整的信用卡信息的API处理支付可能会失败。卡必须通过购物者发起的交易保存,然后才能通过支付API收费。有关支持3DS的支付网关列表,请参见所有可用的支付网关

托管提供商

API流目前不支持托管/离线供应商(如PayPal),也不支持钱包类型的支付(如Amazon Pay)。

储存卡

使用存储卡进行支付有三个步骤。

  1. 收到你的付款方法
  2. 创建访问令牌
  3. 付款流程

要使用存储卡与支付API或结帐SDK,请确保您启用存储卡在商店的控制面板。若要在店面上启用存储的信用卡,请导航到商店设置›支付,并单击支付网关的选项卡。切换开关以启用存储信用卡,然后点击保存。有关启用存储卡的更多信息,请参见启用存储信用卡

存储卡要求

  • 你的商店必须有一个附加计划或更高。
  • 你的商店需要使用优化的单页结账。
  • 你的商店需要使用兼容的支付网关。
  1. 打电话收到你的付款方法为了stored_instruments >标记用存储卡支付的order_id作为查询参数传入。

此令牌与payment_instrument_token让交易


示例响应获取付款方式/得到https://api.bigcommerce.com/stores/ {{store_hash}} / v3 /付款/方法? order_id = {{order_id}}

{“数据”:({“id”:“stripe.card”,“名称”:“条纹”,“测试模式”:真正的,“类型”:“卡”,“supported_instruments”:({“instrument_type”:“签证”,“verification_value_required”:真正的},{“instrument_type”:“万事达”,“verification_value_required”:真正的},{“instrument_type”:“美国运通”,“verification_value_required”:真正的},{“instrument_type”:“发现”,“verification_value_required”:真正的},{“instrument_type”:“杰西博”,“verification_value_required”:真正的},{“instrument_type”:“DINERS_CLUB”,“verification_value_required”:真正的},{“instrument_type”:“STORED_CARD”,“verification_value_required”:真正的}],“stored_instruments”:({“类型”:“stored_card”,“品牌”:“签证”,“expiry_month”:9,“expiry_year”:2020,“issuer_identification_number”:“424242”,“last_4”:“4242”,“令牌”:“050 a1e5c982e5905288ec5ec33f292772762033a070a45g434qfb16bf1940b51ef”,“is_default”:真正的}]}],“meta”:{}}

把…记下来令牌作为处理请求主体中的支付的一部分使用。

创建访问令牌

  1. 请求创建访问令牌获取在处理支付时需要在头中传递的授权令牌。订单的ID需要是请求主体的一部分。

请求创建支付访问令牌/后https://api.bigcommerce.com/stores/ {{store_hash}} / v3 /付款/ access_tokens

{“秩序”:{“id”:215}}

响应创建支付访问令牌

{“数据”:{“id”:“eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJleHAiOjE1NTEzOTQxNDIsIm5iZiI6MTU1MTM5MDU0MiwiaXNzIjoicGF5bWVudHMuYmlnY29tbWVyY2UuY29tIiwic3ViIjoianJhaDZnbW4iLCJqdGkiOiI3Nzg3ZmU1Zi01OWJmLTQ3ZWMtYTFmZC00ZDQ3ZTkwNjFlNWMiLCJpYXd4gJ8uHDk3kDhhuyefsrtr45mRhdGEiOnsic3RvcmVfaWQiOjEwMjU2NDYsIm9yZGVyX2lkIjoyMTUsImFtb3VudCI6OTgwMCwiY3VycmVuY3kiOiJVU0QifX0.WbR90d8m4gn8wK7kPMDEoVq8B0hHC5Ul5H4Hpqq6Yvo”},“meta”:{}}

处理付款

  1. 要处理付款,发送一个邮件到付款流程。您将需要以下信息收到你的付款方法在第一步。

获取支付方法=处理支付

  • 类型=类型
  • 令牌=令牌
  • last_four = verification_value
  • id = payment_method_id

处理支付的报头不同于通常使用BigCommerce API发送的报头。授权令牌是Get Payment Access令牌(第二步)中返回的ID。

  • 接受:应用程序/ vnd.bc.v1 + json
  • 授权:帕特{your-access-token}
  • 内容类型:application / json

帕特

在PAT {your-access-token}之间有一个空格。

请求流程付款示例/后https://payments.bigcommerce.com/stores/ {store_hash} /支付

curl -X POST \ https://payments.bigcommerce.com/stores/{store_hash}/payments \ -H 'Accept: application/vnd.bc。v1+json' \ -H '授权:帕特eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJleHAiOjE1NTEzOTQxNDIsIm5iZiI6MTU1MTM5MDU0MiwiaXNzIjoicGF5bWVudHMuYmlnY29tbWVyY2UuY29tIiwic3ViIjoianJhaDZnbW4iLCJqdGkiOiI3Nzg3ZmU1Zi01OWJmLTQ3ZWMtYTFmZC00ZDQ3ZTkwNjFlNWMiLCJpYXQiOjE1NTEzOTA1NDIsImRhdGEiOnsic3RvcmVfaWQiOjEwMjU2NDYsIm9yZGVyX2lkIjoyMTUsImFtb3VudCI6OTgwMCwiY3VycmVuY3kiOiJVU0QifX0。WbR90d8m4gn8wK7kPMDEoVq8B0hHC5Ul5H4Hpqq6Yvo‘\ - h - type: application / json的\ d{“付款”:{“仪器”:{“类型”:“stored_card”,“令牌”:“050 a1e5c982e5905288ec5ec33f292772762033a0704f46fccb16bf1940b51ef”/ /从获得付款方法“verification_value”:" 4242 "},“payment_method_id”:“条纹。卡"}}

响应流程付款示例

{“数据”:{“id”:“693 bb4cd - 3 f20 - 444 a - 8315 - 6369 - f582c68a”,“状态”:“成功”,“transaction_type”:“购买”}}

如果购买成功,它将返回成功的状态。然后,订单自动移动到等待完成状态。如果你得到不同的回应,看错误代码故障排除。

信用卡

使用信用卡进行支付有两个步骤。

  1. 创建访问令牌
  2. 付款流程

创建访问令牌

  1. 请求创建访问令牌获取在处理支付时需要在头中传递的授权令牌。订单的ID需要是请求主体的一部分。

请求创建支付访问令牌/后https://api.bigcommerce.com/stores/ {{store_hash}} / v3 /付款/ access_tokens

{“秩序”:{“id”:215}}

响应创建支付访问令牌

{“数据”:{“id”:“eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJleHAiOjE1NTEzOTQxNDIsIm5iZiI6MTU1MTM5MDU0MiwiaXNzIjoicGF5bWVudHMuYmlnY29tbWVyY2UuY29tIiwic3ViIjoianJhaDZnbW4iLCJqdGkiOiI3Nzg3ZmU1Zi01OWJmLTQ3ZWMtYTFmZC00ZDQ3ZTkwNjFlNWMiLCJpYXd4gJ8uHDk3kDhhuyefsrtr45mRhdGEiOnsic3RvcmVfaWQiOjEwMjU2NDYsIm9yZGVyX2lkIjoyMTUsImFtb3VudCI6OTgwMCwiY3VycmVuY3kiOiJVU0QifX0.WbR90d8m4gn8wK7kPMDEoVq8B0hHC5Ul5H4Hpqq6Yvo”},“meta”:{}}

处理付款

  1. 为了处理付款,发送a帖子请求付款流程

处理支付的报头不同于通常使用BigCommerce API发送的报头。授权令牌是Get Payment Access令牌(第二步)中返回的ID。

  • 接受:应用程序/ vnd.bc.v1 + json
  • 授权:帕特{your-access-token}
  • 内容类型:application / json

从信用卡发送带有以下字段的请求:

  • 类型 - 将永远是卡
  • payment_method_id -卡的名称的格式payment-provider.card
  • 数量
  • cardholder_name
  • expiry_month
  • exprire_year.
  • verification_value

如果这些字段中的任何一个不正确,您可能无法处理付款。

帕特

在PAT {your-access-token}之间有一个空格。

请求流程付款示例/后https://payments.bigcommerce.com/stores/ {store_hash} /支付

curl -X POST \ https://payments.bigcommerce.com/stores/{store_hash}/payments \ -H 'Accept: application/vnd.bc。v1+json' \ -H '授权:帕特eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJleHAiOjE1NTEzOTQxNDIsIm5iZiI6MTU1MTM5MDU0MiwiaXNzIjoicGF5bWVudHMuYmlnY29tbWVyY2UuY29tIiwic3ViIjoianJhaDZnbW4iLCJqdGkiOiI3Nzgadskfjua451OWJmLTQ3ZWMtYTFmZC00ZDQ3ZTkwNjFlNWMiLCJpYXQiOjE1NTEzOTr4gk78dhshehdGEiOnsic3RvcmVfaWQiOjEwMjU2NDYsIm9yZGVyX2lkIjoyMTUsImFtb3VudCI6OTgwMCwiY3VycmVuY3kiOiJVU0QifX0。WbR90d8m4gn8wK7kPMDEoVq8B0hHC5Ul5H4Hpqq6Yvo' \ -H 'Content-Type: application/json' \ -d '{"payment": {"instrument": {"type": "card", "number": "4242424242424242", "cardholder_name": "Jane Doe", "expiry_month": 12, "expiry_year": 2020, "verification_value": "422"}, "payment_method_id": "stripe "。卡"}}

响应流程付款示例

{“数据”:{“id”:“693 bb4cd - 3 f20 - 444 a - 8315 - 6369 - f582c68a”,“状态”:“成功”,“transaction_type”:“购买”}}

如果购买成功,它将返回成功的状态。然后,订单自动移动到等待完成状态。如果你得到不同的回应,看错误代码故障排除。

存储信用卡

payments API允许开发人员在处理信用卡支付时存储信用卡。

当处理信用支付时,设置save_instrument:true。购物者还可以在结账时储存信用卡。如果你正在使用结帐SDK,它可以将信用卡存储为结账的一部分。

帖子https://payments.bigcommerce.com/stores/ {store_hash} /支付

处理付款示例POST

{“付款”:{“乐器”:{“类型”:“卡”,“数量”:“4111111111111111”,“cardholder_name”:“英国石油公司”,“expiry_month”:12,“expiry_year”:2020,“verification_value”:“411”},“payment_method_id”:“authorizenet.card”,“save_instrument”:真正的}}

使用Orders API

控件创建的订单可以接受付款订单的API。当使用Orders API创建订单时,请确保status_id: 0。如果没有创建订单状态设置为的订单0不完整,支付API将返回一个错误。确保客户在创建订单时输入他们的账单地址和行项目。属性,客户可以将订单创建为客户订单customer_id: 0或者留空。创建订单之后,按照a信用卡或者一个储存卡

创建订单/发布https://api.bigcommerce.com/stores/ {store_hash} / v2 /订单

{“status_id”:0,“customer_id”:11,“billing_address”:{“first_name”:“简”,“姓”:“做”,“公司”:”“,“street_1”:“123大街”,“street_2”:”“,“城市”:“奥斯汀”,“状态”:“德州”,“邮政编码”:“78751”,“国家”:“美国”,“country_iso2”:“我们”,“电子邮件”:“janedoe.com”},“shipping_addresses”:({“first_name”:“Trishy”,“姓”:“测试”,“公司”:“Acme企业有限公司”,“street_1”:“666苏塞克斯圣”,“street_2”:”“,“城市”:“任何地方”,“状态”:“某些国家”,“邮政编码”:“12345”,“国家”:“美国”,“country_iso2”:“我们”,“电话”:”“,“电子邮件”:“janedoe.com”}],“产品”:({“名称”:“BigCommerce海报”,“数量”:1,“price_inc_tax”:10.98,“price_ex_tax”:10},{“名称”:“BigCommerce海报II”,“数量”:1,“price_inc_tax”:50,“price_ex_tax”:45}]}

技术细节

使用考试信用卡

以下是受支持的网关及其测试信用卡的列表。这些在设置应用程序时很有用。检查你的信用卡设置BigCommerce以及支付网关,以确保它们被正确配置。如果信用卡不能使用或停止使用,请联系支付供应商,因为这些信用卡不是由BigCommerce维护的。

令牌

payment_access_token不是来自支付提供商。它是由BigCommerce创建的。

减少支付

拒绝付款将返回一个4XX错误和详细信息,如果有的话。

授权

如果仅配置授权支付网关,则在处理时授权。您需要稍后通过控制面板捕获订单。如果为授权和捕获配置支付网关,则在处理时将授权和捕获付款。

控制面板

通过API创建和捕获的订单看起来与通过店面或其他应用程序创建的订单一样。订单源将是“结帐API”。

数据访问

一旦付款被处理,信用卡数据就不能通过API访问。

速度限制

支付API速率限制是每4秒50个支付请求。一些支付提供商将对传入的请求进行检查。

示例应用图

下图显示了如何payment_access_token与BigCommerce API和BigCommerce付款互动。

控件可以创建订单服务器到服务器的API端点订单的API

示例应用图

样例应用程序图

错误代码

代码 描述 可能的原因 可能的解决方案
10000 API内部发生了一个内部错误。 连接错误 重试请求
10001 缺少或不正确的必需字段。 丢失或不正确的字段 检查请求是否有不正确或丢失的数据
30000 找不到商户付款配置。 *商店中没有配置支付提供商。 检查支付网关BigCommerce商店中的设置。
3001 商户支付配置没有正确配置。 支付网关拒绝支付配置。 检查支付网关BigCommerce商店中的设置。
联系支付网关,检查信息是否正确。
30002 当前vault服务不可用。 这个商店没有启用存储功能。 联系店主,使存储信用卡
30003 找不到秩序。 秩序不存在。
订单ID不正确。
检查商店中使用的当前订单把所有的订单
30004 在线验证项目和总金额不匹配。 N/A 重新创建支付访问令牌
重新创建订单
确保税收和折扣的商店设置设置正确
30050 付款工具无法保存。 信用卡信息不正确。 检查信用卡信息是否正确。
*expiry_month是两位数
*exprire_year.是四位数字
30051 存储的卡片没有找到。 要求付款的卡片与购物者没有关联。 使用收到你的付款方法查看可用的拱形卡
30100 无法创建支付访问令牌。 N/A N/A
30101 订单无效。 订单状态错误。 订单必须处于未完成状态status_id: 0
订单必须由结帐SDK、结帐API或V2订单API创建。在控制面板中创建并设置为incomplete状态的订单将返回此错误。
30102 付款被拒绝了。 所提供的信用卡信息不正确。
提供的令牌不正确。
检查提供的购物者信息是否正确。
确保授权报头字段中的令牌是正确的。
30103 卡已过期。 N/A N/A
30104 付款被拒绝了。如需更多信息,请与发卡机构联系。 N/A N/A
30105 由于提交了重复付款,付款被拒绝了。 N/A N/A
30106 由于资金不足,付款被拒绝。 N/A N/A
30107 由于所存票据不再有效,付款被拒绝。 购物者撤销了与存储的PayPal帐户相关联的支付授权。 N/A

常见问题解答

我如何得到存储的信用卡清单?

使用Get Payment方法获取存储的支付工具列表。

我可以添加我的支付网关吗?

支付API不支持添加第三方网关。支付通过BigCommerce进行处理。

我可以退款吗?

退款可以使用控制面板或直接通过支付网关。

我如何处理缴费信用卡?

授权支付后,捕获步骤将需要使用控制面板

我可以在有多个送货地址的订单上使用这个吗?是的,有多批货物的结帐和订单可以使用支付API。

商店贷款支持吗?

商店信用不是支付API支持的支付方法。商店积分仍然可以被购物者在店面、控制面板或结帐API中使用。

是否支持礼品证书?

支付处理API用于通过商店的支付网关处理支付。由于BigCommerce商店礼品卡不是通过支付网关进行处理的,所以它们不能通过支付处理API进行处理。

是否支持离线支付方式?支付API通过支持的支付网关处理信用卡支付;它不公开用于处理的方法线下支付方式比如货到付款。

是否支持强大的客户身份验证?

使用3D Secure的支付网关满足欧盟强大的客户认证法规要求。要查看BigCommerce支持的哪些支付网关使用3D Secure,请参阅帮助中心的可用的支付网关页面。

相关资源伟德棋牌大全

文章

端点

人则