支付增值服务
接口列表
储值余额和礼品卡
同步充值订单

同步线上充值订单

将客户在原支付系统的充值订单同步到微卡系统

接口说明

请求方式：
post
https://p.wecard.tencent.com/cloudpay/v1/wallet/out/sync_recharge_order

请求参数

Request
Body 包体
RechargeAmount必填
integer

充值金额,单位：分

ThirdPayOrderId必填
string

收单渠道订单号，如微信支付宝的订单号

CreateTime必填
string

订单创建时间，yyyy-MM-dd HH:mm:ss格式

FinishTime必填
string

订单完成时间，yyyy-MM-dd HH:mm:ss格式

FeeAmount选填
number

手续费，单位分

IsFeeUpdated选填
boolean

是否更新手续费，若为true，需要传入手续费

SyncOrderNeedAllocate选填
boolean

同步过来的挂账信息是否需要执行挂账。默认为false不需要，表示传挂账信息只是为了后续退挂账有正向挂账记录，但不会真的执行挂账。为true则表示正常执行挂账

ChannelSubMerchantId必填
string

微卡收付通平台商户编号

PayType必填
string

支付场景:
MINI_PROGRAM：小程序;
PUBLIC:公众号;
PC:网页支付;
H5：手机H5支付;
APP:手机app支付；

最小长度：1     最大长度：50
PayChannel必填
string

支付方式；如：
B2BBANK:企业网银支付;
ENTPAY:银行App支付;
B2BTRANSFER:转账支付;
BALANCEPAY:余额支付;
ALIPAY: 支付宝；
WXPAY:微信支付；
UNIONPAY：银联支付

最小长度：1     最大长度：30
OutRechargeId必填
string

外部充值订单号，即业务系统侧订单号

最小长度：6     最大长度：60
OrderSubject必填
string

订单标题

最小长度：1     最大长度：200
ExpireTime选填
string

订单过期时间，格式：2023-03-05 11:54:20

最小长度：1     最大长度：19
RechargeNotifyUrl选填
string

充值成功后的回调通知地址

最小长度：1     最大长度：255
ExternalPaymentData选填
string

支付渠道扩展字段，第三方通道的扩展信息，根据具体对接的渠道情况传值；
如：微信、支付宝下单时需要将用户的openid或userid，及应用id传入,结构如下

最小长度：1     最大长度：1024
PayerInfo选填
object

用户信息，转账支付、余额支付必填

SceneInfo选填
object

设备信息

FundAllocateList必填
array

挂账信息。支付通道耦合银行账户体系时必填，否则不用。

数组子类型：object

Attachment选填
string

附加信息，在查询API和支付通知中原样返回，可作为自定义参数使用，实际情况下只有支付完成状态才会返回该字段

最小长度：1     最大长度：128
Remark选填
string

付款备注

最小长度：1     最大长度：128

请求示例

{
  "AppId": "1682021751",
  "RechargeAmount": 10,
  "PayType": "MINI_PROGRAM",
  "OrderSubject": "杂粮煎饼",
  "OutRechargeId": "link202411060007",
  "RechargeNotifyUrl": "https://business.com/pay/notify",
  "ExternalPaymentData": "{\"WxAppId\":\"wx4xxxxxxx03e\",\"WxOpenId\":\"oXLUp5Oxxxxxxxx8kc\"}",
  "Currency": "CNY",
  "Attachment": "原路返回string",
  "SceneInfo": {
    "DeviceType": "04",
    "PayerClientIp": "14.15.16.17",
    "DeviceId": "00000001",
    "Longitude": "+121.48352",
    "latitude": "+23.561345"
  },
  "Remark": "备注",
  "PayChannel": "WXPAY",
  "PayerInfo": {
    "PayerId": "1000100680"
  },
  "ChannelSubMerchantId": "CM453726693345990015",
  "ThirdPayOrderId": "linktest000003",
  "CreateTime": "2024-11-06 12:00:00",
  "FinishTime": "2024-11-06 12:03:00"
}

ExternalPaymentData 结构

变量类型是否必填描述
WxAppIdstring否微信开放平台的应用 AppId.(如：公众号、小程序、APP、H5、PC 等应用的 AppId )
WxOpenIdstring否微信用户在当前 WxAppId 下的 Openid，公众号及小程序场景下微信支付必填
AliAppIdstring否支付宝开放平台的应用 AppId.(如：生活号、小程序、APP、H5、PC 等应用的 AppId )
AliUserIdstring否支付宝用户在当前 AliAppId 下的 Userid，生活号及小程序场景下支付宝支付必填
AuthCodestring否支付凭证：用户付款码。被扫场景下必填

返回参数

Response
Response必填
object

返回示例

{
  "Response": {
    "RequestId": "A8E7B797ADD44C3AA57E87AD7420A725",
    "Result": {
      "OutRechargeId": "link202411060007",
      "RechargeAmount": "10",
      "RechargeStatus": "SUCCESS"
    },
    "ErrCode": "SUCCESS",
    "ErrMessage": "成功"
  }
}
腾讯微卡收付通接口文档