废弃订单对接样例

基础介绍

如下图所示，我们将订单支付流程拆分两个阶段：

checkout：顾客填写信息，未支付（一般建议最少等待30分钟）可以执行召回

order：顾客已成功支付订单，不需要进行召回

订单召回流程

事件推荐接口 /api/v1/events

参数 endpoint：checkouts/create 可以激活废弃订单，

自动化过程中需要验证订单是否成功支付，如果启用废弃订单召回功能，必须推送订单orders/paid或orders/update到mamba系统

如下图：召回邮件模板，根据 Checkout Properties 属性填充

对接流程

checkout 阶段：

Shell

curl --request POST \
     --url https://api.mambasms.com/api/v1/events \
     --header 'X-Mamba-Access-Token: 2cf3144e51524c56bce0109cc06fecd1' \
     --header 'accept: application/json' \
     --header 'content-type: application/json' \
     --data '
{
   "endpoint": "checkouts/create",
   "data": {
     ...
 			"token": "", # 对应订单 token
      "abandoned_checkout_url": "" # 恢复购买URL地址
     ...
   },
   "source_id":"幂等"
}
'

checkout 事件字段参考 Checkout Properties

order阶段：

Shell

curl --request POST \
     --url https://api.mambasms.com/api/v1/events \
     --header 'X-Mamba-Access-Token: 2cf3144e51524c56bce0109cc06fecd1' \
     --header 'accept: application/json' \
     --header 'content-type: application/json' \
     --data '
{
   "endpoint": "orders/paid",
   "data": {
     ...
      "checkout_token":"", # 对应checkout token
 			"order_status": "PAID", # 订单状态已支付
       ...
   },
   "source_id":"幂等"
}
'

order 事件字段参考 Order Properties