API 说明

请求类型

POST

请求 URI

/api/v1/payment/local-card/payment

请求参数

字段	类型	是否必需	说明	备注
amount	数值	是	支付金额	以分为单位，100 为 1.00 加币
callBackURL	字符串	是	回调 URL	支付完成后系统向这个 URL 发送通知 (最大长度 255个英文字符)
accountNumber	字符串	是	用户银行卡的账号
accountName	字符串	是	账户持有人的姓名
accountExpire	字符串	是	银行卡的有效期	格式：MMYY
cvn2	字符串	是	银行卡背面的安全码
sslAvsAddress	字符串	否	地址验证系统的地址部分
sslAvsCity	字符串	否	地址验证系统的城市部分
sslAvsProvince	字符串	否	地址验证系统的省份部分
sslAvsCountry	字符串	否	地址验证系统的国家部分
sslAvsZip	字符串	否	地址验证系统的邮政编码部分
sslEciInd	字符串	否	电子商务指示标识
ssl3dsecureValue	字符串	否	用于3D安全验证的值
sslDirServerTranId	字符串	否	3DS安全目录服务器交易ID

请求示例：

{
  "accountNumber": "4000620000000123",
  "accountName": "Jack Smith",
  "accountExpire": "0625",
  "cvn2": "732",
  "sslAvsAddress": "3032920100 CORPORATE SQ",
  "sslAvsCity": "Atlanta",
  "sslAvsProvince": "Georgia",
  "sslAvsCountry": "USA",
  "sslAvsZip": "30327",
  "amount": 20000,
  "callBackURL": "https://uatqrpay.ottpay.com/ac/paymentResult",
  "sslEciInd": "",
  "ssl3dsecureValue": "ssl3dsecureValue",
  "sslDirServerTranId": ""
}

响应结果

字段	类型	说明	备注
reference	字符串	支付通道交易编号
ccType	字符串	银行卡类型	VISA / MC / AMEX
paymentId	字符串	支付编号
amount	字符串	交易金额	以分为单位，100 为 1.00 加币
receiptAmount	字符串	收银条金额	以分为单位，100 为 1.00 加币
totalAmount	字符串	总金额	以分为单位，100 为 1.00 加币
tradeTime	字符串	交易时间	格式： yyyy-MM-DD HH:mm:ss
paymentStatus	字符串	支付状态	`init`/`authorised`/`settelescheduled`/`refused`

响应示例：

{
  "status": "SUCCESS",
  "result": {
    "reference": "MJG498J89TGLNK45",
    "ccType": "visa",
    "paymentId": "1694723098440263",
    "amount": "20000",
    "receiptAmount": "20000",
    "totalAmount": "20000",
    "tradeTime": "2023-09-14 16:25:00 EDT",
    "paymentStatus": "authorised"
  }
}

获得支付结果

OTT Pay API 服务器从支付通道获得支付结果后立即将支付结果发送到指定的 callbackURL。当然商户系统也能通过 支付状态查询 API 进行主动查询。