跳至主要內容

代付订单 · 土耳其

TOPPAY Team大约 2 分钟

请求

代付 API 用于向受益人发起代付交易。本页为 土耳其(国家码 tr)的代付说明。

  • 金额单位为 TRY,正数,最多两位小数(示例:100、100.50)。
  • bankCode 填 BANK,见 地区支付说明 — 土耳其。
  • bankCard 为土耳其 IBAN:大写 TR 加 24 位数字,共 26 位。不要空格,不要小写。示例:TR330006100519786457841326。
  • accountName 去首尾空格后长度为 5~50。

请求路径

域名:推荐使用统一域名 openapi.toppayment.com(路径不变);原国别域名(如 global-tr-openapi.toppayment.com)仍可用。

环境地址
沙箱https://openapi.toppayment.com/sandbox/tr/disbursement/cash
生产https://openapi.toppayment.com/tr/disbursement/cash

请求头

字段必填类型描述
Content-TypeMString固定值:application/json

请求体

字段必填类型描述
mchNoMString(32)商户编号
orderNumMString(50)商户订单号
amountMNumber交易金额(TRY,最多两位小数)
bankCodeMString(32)固定 BANK,见 土耳其代付编码
bankCardMString(50)土耳其 IBAN:TR + 24 位数字,无空格
accountNameMString(50)收款人姓名,长度 5~50
descriptionOString(255)描述
feeTypeMNumber(0或1)手续费类型:0 内扣,1 外扣
downNotifyUrlMString(164)异步通知地址
timestampMString(13)毫秒时间戳
signMStringRSA 签名,参见 签名生成

请求体示例

{
    "mchNo": "{{mchNo}}",
    "orderNum": "TRPAYOUT1234561",
    "amount": 100.50,
    "bankCode": "BANK",
    "bankCard": "TR330006100519786457841326",
    "accountName": "MEHMET YILMAZ",
    "description": "test",
    "feeType": 1,
    "downNotifyUrl": "https://example.com/notify",
    "timestamp": "1749451858772",
    "sign": "按签名规则生成后替换"
}

响应

HTTP响应

字段必填类型描述
Content-TypeMStringHTTP响应内容类型规范
固定值:application/json
指示JSON响应格式

status 见 交易状态码。

{
    "success": true,
    "code": "9999",
    "msg": "SUCCESS",
    "timeStamp": 1767772957433,
    "data": {
        "orderNum": "TRPAYOUT1234561",
        "platOrderNum": "TRANS2008811496544403456",
        "amount": 100.50,
        "fee": 2.00,
        "feeType": 1,
        "status": 1,
        "statusMsg": "ORDER_RECEIVED_PROCESSING",
        "bankCode": "BANK",
        "bankCard": "TR330006100519786457841326",
        "accountName": "MEHMET YILMAZ",
        "description": "test"
    }
}

通知

HTTP请求

字段必填类型描述
Content-TypeMString固定值:application/json

通知体

字段必填类型描述
platOrderNumMString平台订单号
versionMString接口版本号
orderNumMString商户订单号
amountMNumber交易金额
feeMNumber手续费
feeTypeMNumber手续费类型
statusMNumber交易状态,见交易状态码
statusMsgMString状态描述
bankCodeMString银行编码,土耳其固定 BANK
bankCardMString收款 IBAN
accountNameMString收款人姓名
descriptionOString交易描述
signMString通知签名

返回

校验签名后,仅返回字符串 SUCCESS。

SUCCESS

通知示例

{
  "platOrderNum": "TRANS2008811496544403456",
  "version": "v1",
  "orderNum": "TRPAYOUT1234561",
  "amount": 100.50,
  "fee": 2.00,
  "feeType": 1,
  "status": 2,
  "statusMsg": "SUCCESS",
  "bankCode": "BANK",
  "bankCard": "TR330006100519786457841326",
  "accountName": "MEHMET YILMAZ",
  "description": "test",
  "sign": "…"
}