取现

本API为后台版接口,用于商户从汇付账户取现到事先绑定的取现银行卡中。

请求参数

  • 请求地址

https://spin.cloudpnr.com/toppas/enchashment

  • 公共请求参数

请求报文头HEADER - 「接口规则-参数规定-报文头」 ,请求报文体BODY - 「接口规则-参数规定-报文体」 ,响应报文体 - 「接口规则-参数规定-响应报文体」

  • 请求参数(data)
参数 中文名 类型 必填 最大长度 说明
req_seq_id 请求流水号 String Y 128 请求流水号
req_date 请求时间 String Y 8 请求时间
mer_ord_id 商户订单号 String Y 50 取现订单号
huifu_id 商户号 String Y 32 商户号
token_no 取现卡序列号 String Y 20 取现卡序列号
cash_amt 取现金额.单位:元 String Y 14 订单金额
into_acct_date_type 入账类型 String Y 3 T0:当日到账;T1:T1次工作日到账;D1:次自然日到账;
notify_url 异步通知地址 String Y 128 virgo://#{http_server_url} 例:virgo://http://www.xxx.com/getResp
risk_check_info 风控信息 String N 1024 风控信息 ,jsonstring

风控信息

参数 中文名 类型 必填 最大长度 说明
longitude 经度 String Y    
latitude 纬度 String Y    
base_station 基站地址 String Y    

响应参数

  • 同步响应参数(data)
参数 中文名 类型 必填 最大长度 说明
sub_resp_code 业务返回码 String Y 8 业务返回码
sub_resp_desc 业务返回描述 String Y 512 业务返回描述
req_seq_id 业务请求流水号 String Y 128 请求流水号
req_date 业务请求时间 String Y 8 YYYYMMDD
mer_ord_id 商户订单号 String N 32  
hf_seq_id 汇付流水号 String N 128  
trans_status 交易状态 String N 1 S:成功;F:失败;P:处理中
acct_status 账务状态 String N 1 S:成功;F:失败;P:处理中
  • 异步响应参数(resp_data)
参数 中文名 类型 必填 最大长度 说明
sub_resp_code 业务返回码 String Y 8 业务返回码
sub_resp_desc 业务返回描述 String Y 512 业务返回描述
req_seq_id 业务请求流水号 String Y 128 请求流水号
req_date 业务请求时间 String Y 8 YYYYMMDD
mer_ord_id 商户订单号 String N 32 商户订单号
hf_seq_id 汇付流水号 String N 128  
trans_status 交易状态 String N 1 S:成功;F:失败;P:处理中

请求示例

{
        "sys_id":"6666000018269234",
        "data":"{\"token_no\":\"1234232423423432432432\",\"mer_ord_id\":\"89859599-b73a-40c0-a96e-84ff08aed542\",\"into_acct_date_type\":\"T0\",\"req_seq_id\":\"cae47848-e94e-4198-9c0e-c6bb4d5c5635\",\"req_date\":\"20120909\",\"product_id\":\"SPIN\",\"cash_amt\":\"300\",\"_t_o\":\"T0\",\"huifu_id\":\"6666000106120347\",\"notify_url\":\"virgo://http://www.baidu.com\",\"_t1\":\"T1\"}",
        "sign":"B1aTZXHfZZX1IscpMaxADdbUGKgNveaZcvzTfxV0uqD9I7ewvvZML0cMw5i2K4ryQIBEa0RLL52kNIzMJ+rgkz3HwLQQjcGw+ppVm/Cj7T/gBZCcfL6YduEXkC/mgoZeM6GkWM/z6XTC2gsFTM79C+9/H0DG1LH0mOLJ/Rj06JJblqcfgNg8K1vl1VTxdZJ8MMuLbYu593/SVVVX2jeyrWqJSsdngmt84oS1rS2NYXgRWEEB/4E5q4oxtQ8J3YmfevX12AoxQUQWs2PdTPy34ipL1gpoa4SpRnEzV+liDmfkSs9WFxcWNCOlJNPwN8VTNkcMM3EX5Mnbf1H5hWmhJQ==",
        "sign_type":"RSA2"
}

响应示例

{
        "data":"{\"sub_resp_code\":\"10000000\",\"sub_resp_desc\":\"返回描述\",\"top_region_id\":\"TOP3_A\",\"trans_status\":\"F\"}",
        "resp_code":"10000",
        "resp_desc":"成功调用",
        "sign":"IF9BXh58PJD0OiDiN6BuZ2KVYfu48ivs9raHG2E4jwRcNgLigf6/9Y1d21LePPLe3xsdsOsNd5FlhNZE9/HRXVnRkXHQChXZihFHeyMW/Sxod0t5xORHvMSryNxzqA9673MDl0LIPMLVkry/lWURMx7WkbnL7de0EeXO8a5fJ2CCMxDhH6WCoPQ9lzZmxALXc7I1BsOojxUweAB0DgcQ86eEfPy5A1h95e/h61PvZ3F+RaA7Zzg0R6G6Er5fWeyoeDglGnPfJ56L4xIDi09Dc9zDoxkMEiSPNsjNxyrSwaqVjVzHvSyVzXH4G+SwFQUeQK+TxVAA5QmrR9PYXQKYfw=="
}

接口调用示例

Demo参考