抗辩申诉接口文档

业务流程

Image without caption
Tips:
  1. 抗辩服务覆盖范围
      • 除信用卡外,还可以处理Paypal、Klarna等钱包类工具的争议案件
      • 支持欺诈类拒付抗辩,但需要传输额外的字段
  1. 抗辩服务时间要求:
    1. 收单机构给到商户的时间:
      • 信用卡:一般为16天
      • paypal等钱包支付方式:一般为12天
      跨拒通时效设置:
    2. T1: 接收到拒付消息后,给到商家准备材料的时间: 建议为5天
    3. T2: 上传材料后,跨拒通的初审时间: 3天时间
    4. T3: 跨拒通给出补充意见后,商户补充材料的时间:建议为2天时间
    5. T4: 跨拒通最后的审核时间:建议为2天
  1. 商户沟通需求(为提高胜率,建议允许跨拒通在以下情况下直接联系商家):
    1. 商家未在规定时间内补充材料
    2. 商家补充材料后仍然不符合抗辩要求
  1. 以下4类拒付建议放弃抗辩:
      • 未采用3D验证的欺诈类拒付
      • 拒付时商家尚未发货
      • 买家已将货物退回
      • 低于拒付处理费&抗辩成本的低金额交易(例如15USD以下)

安全与加密方式

  • 要使用我们的 API,您将需要某些凭据,我们将使用这些凭据来识别和授权使用拒付抗辩 API服务。请通过 support@tradefensor.com 联系我们 以获取您的凭据。您应该从我们这里获得以下凭据才能开始使用 API
名字
描述
MerchantNo
将用于在使用 API 时识别您的身份并获取用于访问受限资源的授权令牌。
SignKey
需要它来获取用于访问受限资源的授权令牌。

接口参数

  • 通讯方式:https + JSON
  • 字符集: UTF-8
  • 加密方式: MD5 Salt
  • Request Body
    • Content Type application/json
  • API 域名
    • 生产环境:https://mer.tradefensor.com
  • 加密方式
    • 加密:MD5 (参与签名的参数按照ASCII码从小到大排序,将参数按固定顺序组装成签名原始串以“&”拼接,最后在拼接上商户密钥。签名的参数顺序和格式如下:key1=value1&key2=value2...keyn=valuen*****)
java
import com.alibaba.fastjson.JSON; import com.alibaba.fastjson.JSONArray; import com.alibaba.fastjson.JSONObject; import org.apache.commons.lang3.StringUtils; import org.apache.http.HttpException; import java.io.IOException; import java.io.UnsupportedEncodingException; import java.security.MessageDigest; import java.security.NoSuchAlgorithmException; import java.util.*; public class TestSign { public static String sign(Map<String, Object> paramValues, String secret) { StringBuilder sb = new StringBuilder(); List<String> paramNames = new ArrayList<String>(paramValues.size()); paramNames.addAll(paramValues.keySet()); Collections.sort(paramNames); for (String key : paramNames) { Object value = paramValues.get(key); if (value == null || StringUtils.isBlank(value.toString())) { continue; } String value_inner = value.toString(); if (value_inner.startsWith("[")) { sb.append("&").append(key).append("=").append(parseJsonArray(value_inner)); } else if (value_inner.startsWith("{")) { Map requestMap = JSON.parseObject(value_inner); sb.append("&").append(key).append("=").append(sign(requestMap, secret)); } else { sb.append("&").append(key).append("=").append(value.toString()); } } sb.append("&").append(secret); String str = sb.substring(1,sb.length()); return disguiseMD5(str,"UTF-8"); } private static JSONArray parseJsonArray(String jsonArrayString) { List<Map<String, Object>> list = (List<Map<String, Object>>) JSONArray.parse(jsonArrayString); List<JSONObject> result = new LinkedList<JSONObject>(); for (Map<String, Object> map : list) { List<String> paramNames = new ArrayList<String>(map.size()); paramNames.addAll(map.keySet()); Collections.sort(paramNames); //JSONObject.toJSONString(json, SerializerFeature.SortField) JSONObject jsonObject = new JSONObject(true); for (String key : paramNames) { Object value = map.get(key); if (value == null || StringUtils.isBlank(value.toString())) { continue; } jsonObject.put(key, value); } result.add(jsonObject); } // logger.info("\nJSONArray 内JSONObject排序:{}\n", result); Collections.sort(result, (JSONObject o1, JSONObject o2) -> { Integer o1_index = o1.getInteger("index"); Integer o2_index = o2.getInteger("index"); if (o1_index == null || o2_index == null) { throw new IllegalArgumentException("参数明细中需要指定INDEX"); } return o1_index.compareTo(o2_index); }); // logger.info("\nJSONArray 排序:{}\n", result.toString()); JSONArray jsonArray = new JSONArray(); for (JSONObject jsonObject : result) { jsonArray.add(jsonObject); } return jsonArray; } public static String disguiseMD5(String message, String encoding) { if (null == message || null == encoding) { return null; } message = message.trim(); byte value[]; try { value = message.getBytes(encoding); } catch (UnsupportedEncodingException e) { value = message.getBytes(); } MessageDigest md = null; try { md = MessageDigest.getInstance("MD5"); } catch (NoSuchAlgorithmException e) { return null; } return toHex(md.digest(value)); } public static String toHex(byte input[]) { if (input == null) { return null; } StringBuffer output = new StringBuffer(input.length * 2); for (int i = 0; i < input.length; i++) { int current = input[i] & 0xff; if (current < 16) { output.append("0"); } output.append(Integer.toString(current, 16)); } return output.toString(); } public static void main(String[] args) throws IOException, HttpException { Map<String, Object> paramValues = new HashMap<>(); paramValues.put("test","222"); System.out.println(sign(paramValues,"Hr2JXE5mHjUL3vopraYZrZWDzfMaA0OLAvs5QxsIdJc=")); } }

合作清单

协助我们的新合作伙伴进行 API 集成、开发和测试的清单。
Item
Description
在生产中将 IP/s 列入白名单
eg. 111.222.333.444
接收加密生产 API_KEY等信息的电子邮件地址。

流程图

  • 当发起抗辩,提供完善的材料时,虚线处 step3和 step4则不会发生
Image without caption

接口文档

数据结构&释义

  1. 支付、拒付、订单之间的关系:
      • 1 笔【拒付】对应 1 笔【支付】
      • 1 笔【支付】对应 N 笔【订单】
      • 1 笔【订单】对应 N 个【商品】、N个【物流】、N个【交易历史】、1个【买卖家】、1笔【退款】、1笔【质量证明】、1笔【售后】 、1笔【商家陈述】
xml
一笔拒付任务的示例: chargeback1 payment1 (第1笔订单数据) - contract1 - Seller&buyer1 - Products1_1 | Products1_2 - Quality1 - Shipping1_1 | Shipping1_2 - Return&Refund1 - Aftersales1 - History1 | History1 - Statement (第2笔订单数据) - contract2 - Seller&buyer2 - Products2_1 | Products2_2 - Quality2 - Shipping2_1 | Shipping2_2 - Return&Refund2 - Aftersales2 - History2_1 | History2_2 - Statement

Step1 收集抗辩材料

1. Chargeback

ChargeBack
Field Name
Required
Description
Field Type
Example
Validation
merchant_no
required
固定值,合作机构号
string
SGB001626
强校验必填。英文、数字或符号组合
sub_merchant_no
required
子商户号(如有)
string
shopify
强校验必填。英文、数字或符号组合
merchant_order_no
required
机构唯一标识一笔拒付的编号
string
T10232545
强校验必填。英文、数字或符号组合
cb_no
required
收单机构的拒付参考号。该编号出现在抗辩文件中,让收单机构和发卡行对拒付进行识别
string
CB012345
强校验必填。英文、数字或符号组合
chargeback_date
required
拒付发生时间
string
2023-01-01
强校验必填。yyyy-mm-dd
chargeback_amount
required
拒付金额
string
55.94
强校验必填。大于0的数值
chargeback_currency
required
拒付币种
string
EUR
强校验必填。3位英文字母
represent_due_date
optional
抗辩截止时间,一般可以从收单机构获取该信息
string
2023-01-15
yyyy-mm-dd
reason_code
required
拒付原因码。从收单渠道获取。
string
10.4
英文、数字或符号组合
reason_desc
optional
拒付原因描述
string
other fraud card-absent Environment
英文、数字或符号组合
card_scheme
required
信用卡卡组名称
string
VISA
VISA MASTERCARD AMEX JCB DISCOVER DINERS PAYPAL OTHERS
issue_comments
optional
买家在银行端发起拒付时的留言
string
I haven't received my goods yet..
英文、数字或符号组合
case_type
optional
标记抗辩类型是:首次抗辩、二次抗辩、仲裁
string
first chargeback
枚举值。first_chargeback-首次抗辩,second_chargeback-二次抗辩,pre_arb-升级仲裁
is_fraud
optional
该笔拒付是否出现在收单机构提供的欺诈报告中
string
N
Y/N
is_blacklisted
optional
持卡人是否出现在收单机构的黑名单列表中
string
N
Y/N
decision
optional
商户表明是否进行抗辩(全部默认为Y)
string
Y
Y/N,默认为Y

2. Payment

Payment
Field Name
Required
Description
Field Type
Example
Validation
arn
optional
收单行参考编号(ARN)是您的银行或信用卡公司用于查找退款的跟踪信息的号码,一般为22位数字编号
string
12345678901234567890123
英文、数字或符号组合
transaction_date
required
支付时间
string
2023-01-15
yyyy-mm-dd
transaction_amount
required
支付金额
string
55.94
大于0的数值
transaction_currency
required
支付币种
string
EUR
3位英文字符
pay_channel
optional
收单服务商名称
string
ayden
英文、数字或符号组合
mid
optional
收单机构给予商户的商户识别码
string
SG100010001USD
英文、数字或符号组合
card_bin
optional
卡号前6位
string
411111
6位数字
card_last_four
optional
卡号后4位
string
5115
4位数字
issuer
optional
发卡行名称
string
chase
英文、数字或符号组合
cardholder_name
required
持卡人姓名
string
Tommy
英文、数字或符号组合
authorization_code
optional
支付授权码
string
10560
英文、数字或符号组合
issue_country
optional
发卡国
string
USA
3位字母
billing_address
required
买家在支付时填写的账单地址
string
John Doe 1234 Elm St Apt 567 Los Angeles, CA 90001 USA (格式一般是:收件人+街道地址+公寓号+城市+州/省+邮政编码+国家)
英文、数字或符号组合
avs_result
optional
地址验证结果
string
Y(Y/A/Z/N/U/R/S/W/X/D)
英文、数字或符号组合
otp_result
optional
3D验证结果
string
Y(Y/N/A/U/C/R)
英文、数字或符号组合
eci_ucaf_value
optional
ECI值
string
06 (02/05/06/07)
英文、数字或符号组合
pares_result
optional
PARes值
string
Y (Y/N/A/U)
英文、数字或符号组合
cavv_result
optional
CAVV验证结果
string
Y(Y/N/A/U)
英文、数字或符号组合
cvv_result
optional
CVV验证结果
string
M(M/N/P/S/U)
英文、数字或符号组合

3. Seller&buyer

Seller&buyer
Field Name
Required
Description
Field Type
Example
Validation
is_repeat_customer
optional
买家是否为老客户
string
Y
Y or N
seller_id
optional
卖家账号
string
aa774474
英文、数字或符号组合
seller_name
required
店铺名称
string
河南凯沃机械有限公司
中文、英文、数字或符号组合
website
required
店铺网址
string
www.semi.com
英文、数字或符号组合
categories
optional
订单商品类目名称
string
mobile phone
英文、数字或符号组合
seller_country
optional
卖家国别
string
USA
3位字母
descriptor
required
信用卡收单的 descriptor(描述符)是商家在客户信用卡账单上显示的交易描述信息
string
amazon/alibaba.com
英文、数字或符号组合
buy_descriptor
optional
买家账单地址
string
amazon/alibaba
英文、数字或符号组合
business_model
optional
01-trading_comany 02-factory 03-others
string
01-trading_comany
2位数字
seller_email
required
卖家联系邮箱。我们可以通过该邮箱联系商家补充材料。
string
abc@abc.com
英文、数字或符号组合
seller_phone
required
卖家联系电话。我们可以通过该电话联系商家补充材料。
string
13311223132
英文、数字或符号组合
return_address_country
optional
商家退货地址_国家
string
China
3位字母
return_address_province
optional
商家退货地址_州/省
string
Guangdong
英文、数字或符号组合
return_address_city
optional
商家退货地址_城市
string
New York
英文、数字或符号组合
return_address_line1
required
商家退货地址_街道1(如果退货地址不方便拆分,可以在该字段中传入一个完整地址)。地址格式为:收件人+街道地址+公寓号+城市+州/省+邮政编码+国家
string
Tianhe street(John Smith 456 Elm Street Apt 12B Springfield, IL 62704 USA)
英文、数字或符号组合
return_address_line2
optional
商家退货地址_街道2
string
Tianhe street
英文、数字或符号组合
return_address_zipcode
optional
商家退货地址_邮编
string
93110
英文、数字或符号组合
return_recevier
required
退货收件人。可以默认为商家英文名称。
string
Xiaomi technology
英文、数字或符号组合
return_address_contract
optional
退货人联系方式
string
Guandong tianhe street 00910
英文、数字或符号组合
buyer_name
optional
买家名称
string
bb774474
英文、数字或符号组合
buyer_country
optional
买家国别
string
USA
3位字母
ip_address
optional
付款人IP地址
string
192.19.01.250
英文、数字或符号组合
email_address
optional
买家邮箱地址
string
abc@abc.com
英文、数字或符号组合
social_media
optional
买家社交媒体名称
string
facebook/twitter
英文、数字或符号组合
ssn
optional
买家社交媒体账号
string
acb@twitter
英文、数字或符号组合
url
optional
买家社交媒体地址
string
http://youtube.com
英文、数字或符号组合
device_id
optional
买家设备号
string
10561
英文、数字或符号组合
device_name
optional
买家设备名称
string
femi's iphone
英文、数字或符号组合
device_type
optional
枚举值 01-MAC 02-Windows 03-Android 04-IOS 05-Other
string
mac
英文、数字或符号组合
browser_type
optional
枚举值: CHROME FIREFOX SAFARI EDGE INTERNET_EXPLORER OPERA OTHERS
string
Edgex
英文、数字或符号组合

4. Contract

Contract
Field Name
Required
Description
Field Type
Example
Validation
order_no
required
订单号
string
12345678901
强校验必填。英文、数字或符号组合
create_time
optional
订单创建日期
time
2023-11-06 15:30:00
yyyy-mm-dd hh:mm:ss
total_amount
optional
订单总金额
double
800
大于0的数值
transaction_amount
required
交易金额
double
200
大于0的数值
transaction_currency
required
交易币种
string
USD
3位字母
initial_amount
optional
约定首款金额
double
200
大于0的数值
balance_amount
optional
约定尾款金额
double
600
大于0的数值
shipping_fee
optional
运费
string
190
大于0的数值
quota_coupon
optional
优惠券金额
string
20
大于0的数值
vat_amount
optional
增值税费
string
10
大于0的数值
bank_charge
optional
支付手续费
double
2.99
大于0的数值
market_type
optional
默认为电商场景ECOMMERCE
string
1-ECOMMERCE 2-DIGTITAL 3-INSTITUTION 4-TRAVEL 5-RETAIL 6-OTHERS
英文、数字或符号组合
receiver
required
收货人名称
string
peter piper
英文、数字或符号组合
receiver_phone
optional
收货人联系方式
string
010 3994884
英文、数字或符号组合
receiver_address_country
optional
收货人地址_国家
string
USA
3位字母
receiver_address_state
optional
收货人地址_州省
string
FL
英文、数字或符号组合
receiver_address_city
optional
收货人地址_城市
string
FL
英文、数字或符号组合
receiver_address_street_line1
required
收货人地址_街道1。(如果收货地址不方便拆分,可以在该字段中传入一个完整地址)。地址格式为:收件人+街道地址+公寓号+城市+州/省+邮政编码+国家
string
Tianhe street
英文、数字或符号组合
receiver_address_street_line2
optional
收货人地址_街道2。如果已发货,则必填。
string
Tianhe street
英文、数字或符号组合
receiver_address_zipcode
optional
收货人地址_邮编。如果已发货,则必填。
string
93110
英文、数字或符号组合
trade_term
optional
贸易术语
string
EXW
英文、数字或符号组合
due_shipping_date
optional
约定发货日 如果该字段有值,则该字段为必填
string
2023-01-15
yyyy-mm-dd
shipping_method
optional
运输方式
string
air
2为数字。枚举值 01-express 02-sea 03-air 04-railway 05-truck 06-others
estimated_delivery_date
optional
约定到货日 如果该字段有值,则该字段为必填
string
2023-01-15
yyyy-mm-dd
returnpolicy_screenshots
optional
展示您店铺的退换货政策,例如:是否支持退换货、售后服务方案等。 示例:
string
a5b91f31-3da6-4d7d-b998-9bc151590f42
fileNo,上传文件接口给客户返回的唯一号码。多个文件用逗号隔开
returnpolicy_comments
required
商家退货政策描述。如果退换货规则统一,可以在这里传送固定值
string
This store supports 7 days of no reason return, 30 days of negotiated refund, and 180 days of extended warranty after-sales service
英文、数字或符号组合
order_screen_shots
required
商家后台展示订单信息的截图。支持传送多张图片。
string
a5b91f31-3da6-4d7d-b998-9bc151590f42
fileNo,我们上传文件接口给客户返回的唯一号码。多个文件用逗号隔开
order_comments
optional
商家关于订单信息的补充描述
string
The first screenshot was our initial agreement, and the changes that occurred later are shown in screenshot 2
英文、数字或符号组合

5. Products

Products
Field Name
Required
Description
Field Type
Example
Validation
prod_name
required
商品英文名称
string
food truck
不超过200位的英文、数字或符号组合
prod_page
optional
商品详情页截图 能够展示商品外观、颜色、尺寸、单价、包装、运输、售后等信息的截图
string
a5b91f31-3da6-4d7d-b998-9bc151590f42
fileNo,上传文件接口给客户返回的唯一号码。多个文件用逗号隔开
sku
optional
商品SKU信息:型号/颜色/尺寸等
string
iphone14plus/red/250g
英文、数字或符号组合
prod_url
required
商品链接。链接可以打开,查询到商品详情。
string
英文、数字或符号组合
item_price_amt
required
货物单价
double
13.2
大于0的数值
item_price_currency
optional
货物币种
string
USD
3位字母
prod_subtotal
required
货物件数
string
50
大于0的数值

6. Quality

Field Name
Required
Description
Field Type
Example
Validation
quality_agreement
required
(图片)可以证明商家已按照双方约定进行生成的举证材料,例如双方聊天记录、商品检测报告、发货前照片等。如果拒付原因是“未收到货”类型,可以不填写
string
a5b91f31-3da6-4d7d-b998-9bc151590f42
fileNo,上传文件接口给客户返回的唯一号码。多个文件用逗号隔开
quality_agreement_comments
optional
关于质量约定的补充说明
string
The buyer has changed the color of some products from red to purple
中文、英文、数字或符号组合
quality_check
optional
(图片)买家确定商品已按约定生产的截图,聊天记录或电子邮件等截图均可
string
a5b91f31-3da6-4d7d-b998-9bc151590f42
fileNo,上传文件接口给客户返回的唯一号码。多个文件用逗号隔开
quality_check_comments
optional
关于买家确定已按照约定生产的补充说明
string
The picture shows that the buyer has already expressed their satisfaction with the product during the chat
中文、英文、数字或符号组合
quality_used
optional
(图片)商品验货报告、质检证书、测试报告、买家已使用商品的证据等
string
a5b91f31-3da6-4d7d-b998-9bc151590f42
fileNo,上传文件接口给客户返回的唯一号码。多个文件用逗号隔开
quality_used_comments
optional
买家已使用商品的证据的补充说明
string
The picture shows that the buyer has already used the goods for his house decoration
中文、英文、数字或符号组合
quality_proof
optional
(图片)商品验货报告/质检证书/测试报告
string
a5b91f31-3da6-4d7d-b998-9bc151590f42
fileNo,上传文件接口给客户返回的唯一号码。多个文件用逗号隔开
quality_proof_comments
optional
关于商品验货报告/质检证书/测试报告的补充说明
string
I had SGS inspect the goods before shipping, and the inspection proved that the goods were qualified
中文、英文、数字或符号组合
product_preshipment
optional
(图片)发货前的货物照片,最好能展示货物细节
string
a5b91f31-3da6-4d7d-b998-9bc151590f42
fileNo,上传文件接口给客户返回的唯一号码。多个文件用逗号隔开
product_preshipment_comments
optional
关于发货前货物照片的补充说明
string
The detailed photos of the goods taken before shipment show that the color fully meets the contractual requirements
中文、英文、数字或符号组合
product_certificate
optional
(图片)证明商家符合相关行业资质/获取授权的凭证,常见有产地证书、认证证书、授权证书、专利证书等
string
a5b91f31-3da6-4d7d-b998-9bc151590f42
fileNo,上传文件接口给客户返回的唯一号码。多个文件用逗号隔开
product_certificate_comments
optional
关于商家资质的补充说明
string
Our company has obtained a 3C electronic industry certification
中文、英文、数字或符号组合

7. Shipping

Field Name
Required
Description
Field Type
Example
Validation
shipment_no
optional
物流批次号(机构指定唯一标记物流单的号码)
string
AA111112
不超过100位的英文、数字或符号组合
logistic_provider
required
物流承运商。如果已发货必填。
string
UPS
中文、英文、数字或符号组合
tracking_website
required
物流承运商用于查询物流轨迹的官网地址。如果已发货必填。
string
www.fedex.com
英文、数字或符号组合
tracking_number
required
可以用于查询轨迹的物流运单号。如果已发货必填。
string
1z24058408
英文、数字或符号组合
actual_shipment_date
required
实际发货时间,如果有值则必填
date
2023-11-06 15:30:00
yyyy-mm-dd hh:mm:ss
delivery_date
optional
货物妥投日,如果货物已妥投,则该字段必填
date
2023-11-06 15:30:00
yyyy-mm-dd hh:mm:ss
delivery_receiver
optional
实际收件人名称,如果有值则必填
string
peter piper
中文、英文、数字或符号组合
delivery_phone
optional
收件人联系方式
string
010 3994884
不超过200位的英文、数字或符号组合
delivery_address_country
optional
妥投地址_国家
string
China
3位字母
delivery_address_state
optional
妥投地址_州省。
string
FL
英文、数字或符号组合
delivery_address_city
optional
收货人地址_市
string
FL
英文、数字或符号组合
delivery_address_street_line1
optional
妥投地址_街道1
string
Tianhe street
英文、数字或符号组合
delivery_aaddress_street_line2
optional
妥投地址_街道2
string
Tianhe street
英文、数字或符号组合
delivery_aaddress_zipcode
optional
妥投地址_邮编
string
93110
英文、数字或符号组合
proof_of_shipment
optional
发货凭证截图,能够清晰显示收货地址和发货名称、数量等 示例:
string
a5b91f31-3da6-4d7d-b998-9bc151590f42
fileNo,上传文件接口给客户返回的唯一号码。多个文件用逗号隔开
shipment_proof_comments
optional
关于发货情况的补充说明
string
We have renegotiated the delivery time with the buyer, and I have shipped according to the agreed time
中文、英文、数字或符号组合
proof_of_delivery
required
(图片)证明买家是否已收到货,例如妥投证明,物流轨迹截图、买家签收记录、上门提货证明。
string
a5b91f31-3da6-4d7d-b998-9bc151590f42
fileNo,上传文件接口给客户返回的唯一号码。多个文件用逗号隔开
delivery_proof_comments
optional
关于货物妥投情况的补充说明(例如对于货物延期、货物破损、丢失的原因说明等)
string
The picture is a screenshot of the logistics official website
中文、英文、数字或符号组合
transport_proof
optional
(图片)合同约定/电子邮件/聊天记录均可。买卖双方关于运费、清关费用等的约定,
string
a5b91f31-3da6-4d7d-b998-9bc151590f42
fileNo,上传文件接口给客户返回的唯一号码。多个文件用逗号隔开
transport_proof_comments
optional
关于运费、清关费用约定的补充说明
string
We agree that the customs clearance fee will be borne by the buyer
中文、英文、数字或符号组合
delivery_chatting
optional
(图片)买家表达已经收到货物的证明,聊天记录或电子邮件等截图
string
a5b91f31-3da6-4d7d-b998-9bc151590f42
fileNo,上传文件接口给客户返回的唯一号码。多个文件用逗号隔开
delivery_chatting_comments
optional
关于买家表达已收货的补充说明
string
Picture shows that the buyer has received the goods
中文、英文、数字或符号组合

8. Return&Refund

Field Name
Required
Description
Field Type
Example
Validation
is_return
required
商家是否接受退货
string
Y/N
1位字母
retrun_tracking_website
optional
退货物流追踪号查询网址
string
www.fedex.com
英文、数字或符号组合
return_tracking_number
optional
退货追踪单号,
string
1z24058408
英文、数字或符号组合
return_delivery_date
optional
退货妥投日
date
2023-01-15
yyyy-mm-dd
proof_of_delivery
optional
退货妥投凭证截图
string
a5b91f31-3da6-4d7d-b998-9bc151590f42
fileNo,上传文件接口给客户返回的唯一号码。多个文件用逗号隔开
is_refund
required
商家是否已退款
string
Y/N
英文、数字或符号组合
refund_arn
optional
退款的ARN号码
string
2131231243154534523422
英文、数字或符号组合
refund_date
optional
退款时间 如果已退款,则该项必填
string
2023-01-15
yyyy-mm-dd
refund_amount
optional
退款金额 如果已退款,则该项必填
string
55.94
大于0的数值
refund_currency
optional
退款币种(3位币种映射码)
string
gbp
3位字母
refund_proof
optional
(图片)卖家侧展示已退款的凭证
string
a5b91f31-3da6-4d7d-b998-9bc151590f42
fileNo,上传文件接口给客户返回的唯一号码。多个文件用逗号隔开
refund_proof_comments
optional
关于卖家已退款的补充说明
string
The picture proves that I have completed the refund to the buyer
中文、英文、数字或符号组合
proof_of_cancelchargeback
required
(图片)如果买家已撤销拒付,则该字段必填。买家已取消拒付的证明。如果买家已在银行撤销拒付,请您联系买家提供相关证明
string
a5b91f31-3da6-4d7d-b998-9bc151590f42
fileNo,上传文件接口给客户返回的唯一号码。多个文件用逗号隔开
cancelcb_proof_comments
optional
关于买家已取消拒付的补充说明
string
The buyer presented proof that he had cancelled the refusal of payment at the bank
中英文文本

9. Aftersales

Field Name
Required
Description
Field Type
Example
Validation
aftersales_proof
optional
卖家已进行售后维修的凭证
string
a5b91f31-3da6-4d7d-b998-9bc151590f42
fileNo,上传文件接口给客户返回的唯一号码。多个文件用逗号隔开
aftersales_proof_comments
optional
关于售后维修的补充说明
string
The buyer presented proof that he had cancelled the refusal of payment at the bank
中文、英文、数字或符号组合

10. History

Field Name
Required
Description
Field Type
Example
Validation
is_repeat_customer
optional
买家是否老客户,如果不是首次交易,请arn、receiver、receiver2为必填
string
Y/N
英文、数字或符号组合
order_no
optional
订单号
string
12345678901
英文、数字或符号组合
pay_arn
optional
支付单号ARN,或者可以唯一标识该笔支付的编号
string
12345678901
英文、数字或符号组合
create_time
optional
订单支付时间
time
2023/1/1
yyyy/mm/dd
transaction_amount
optional
支付额
double
200
大于0的数值
transaction_currency
optional
支付币种
string
USD
3为字母
receiver
optional
买家的下列信息,选其一: Ip address device ID
string
IOS1232121
英文、数字或符号组合
receiver2
optional
填写除receiver外的,买家第二个标识信息,以下选填一个: Shipping address(买家收货地址) Device id User ID(买家登陆账号、登录名或者邮箱号等)"
string
peter piper
英文、数字或符号组合

11. Statement

Field Name
Required
Description
Field Type
Example
Validation
merchant_comments
required
"商家总结陈辞。支持中英文,控制在3000字以内,可以包括: 1. 关于已提交证据的补充说明 2. 简要描述订单履约情况 3. 针对拒付原因,对买家提出的问题进行反驳 4. 提出解决方案,例如同意部分退款等
string
I do not accept the chargeback for the reasons below. Firstly, xxxx.
中文、英文、数字或符号组合
other_evidence
optional
其他补充材料
string
a5b91f31-3da6-4d7d-b998-9bc151590f42
fileNo,上传文件接口给客户返回的唯一号码。多个文件用逗号隔开

Step2 返回抗辩和审核结果

我们对每笔拒付输出审核意见:
  • order_status=Waiting_Mer_materials:表示需要补充材料,输出结果:
    • 订单号(merchant_order_no),只会列出需要补充材料的订单号
    • 审核意见(eligibility_note),描述每个订单补充哪些材料
  • order_status=SubmitDownload:表示不需要补充材料,输出结果:
    • 抗辩文件的下载链接 (downPath)
    • 审核结果(按照每个订单给出审核结果):
      • 订单号(merchant_order_no),包含所有订单号
      • 商家是否有责(judgment_result )包括商家有责、商家无责
      • 审核意见 (eligibility_note)描述商家有责的原因
Field Name
Required
Description
Field Type
Example
Validation
merchant_no
required
引用chargeback表里的merchant_no字段
string
I do not accept the chargeback for the reasons below. Firstly, xxxx.
中文、英文、数字或符号组合
merchant_order_no
required
引用chargeback表里的merchant_order_no字段
string
KRLD00
fileNo,上传文件接口给客户返回的唯一号码。多个文件用逗号隔开
order_status
required
任务状态码,枚举值 1. SubmitDownload 2. Waiting_Mer_materials
string
AL553234
中文、英文、数字或符号组合
downPath
optional
抗辩文件下载链接,当order_status=SubmitDownload时返回值
string
https://312d123.tradefensor.com
中文、英文、数字或符号组合
sign
required
签名
string
a5b91f31-3da6-4d7d-b998-9bc151590f42
中文、英文、数字或符号组合
order_results
required
-
object[ ]
-
-order_no
required
子订单号
string
0102312
中文、英文、数字或符号组合
-judgment_result
optional
当order_status=SubmitDownload时,该字段返回值: 1. 商家全责 "YES" 2.商家无责"NO" 3..部分有责 "PART”
string
YES
中文、英文、数字或符号组合
-judgment_amount
optional
子订单金额
string
106
中文、英文、数字或符号组合
-judgment_currency
optional
子订单币种
string
USD
中文、英文、数字或符号组合
-eligibility_note
required
1.如果是需要补充材料,该字段为补充材料意见 2.如果不需要补充材料,该字段为最终审核意见
string
未在约定时间内妥投不符合赔付条件
中文、英文、数字或符号组合

Step3 接收发卡行判责结果

  • 我们需要知晓每笔抗辩的最终判责结果,用于费用结算和抗辩策略调整
Field Name
Required
Description
Field Type
Example
Validation
cb_result
required
发卡行最终判责结果,枚举值: 1.PASS,商家胜诉 2.FAIL,商家败诉
string
PASS
英文字符
merchant_no
required
引用chargeback表里的merchant_no字段
string
KRLD00
中文、英文、数字或符号组合
merchant_order_no
required
引用chargeback表里的merchant_order_no字段
string
AL553234
中文、英文、数字或符号组合
sign
required
签名
string
-

由...提供支持 Notaku