代付文档

代付文档

请求URL:

https://www.ampay.club/daifu/Transfer/index

请求方式：

POST

Content-Type: application/json

参数名	必填	签名	描述
memberid	是	是	商户号
orderid	是	是	商户订单号
amount	是	是	订单金额，单位 元
orderdatetime	是	是	订单提交时间，格式：YYYY-mm-dd HH:ii:ss 例如：2020-02-02 20:20:20
currency	是	是	币种 （巴西）brl、(秘鲁) pen 具体的请咨询客服
notifyurl	是	是	回调通知地址
data	是	是	代付信息数据，具体的见最下面附录
remarks	否	否	扩展字段
sign	否	否	md5签名，签名算法在下面：

签名算法:

签名生成的通用步骤如下：

第一步，设（除 data、remarks、sign 以外）数据为集合M，将集合M内的参数按照参数名ASCII码从小到大排序（字典序），使用URL键值对的格式（即key1=value1&key2=value2…）拼接成字符串 stringA。

第二步，设 data 数据为集合O，将集合O内的参数按照参数名ASCII码从小到大排序（字典序），使用URL键值对的格式（即key1=value1&key2=value2…）拼接成字符串 stringB。data 里的所有参数（包括为空的参数）都参与签名

第三步，将 stringA 与 stringB 通过 & 符号（stringA + & + stringB）连接成字符串 stringC。

第四步，在stringC最后拼接上key（签名密钥）得到stringSign（stringC + key）字符串，并对stringSign进行MD5运算，再将得到的字符串所有字符转换为大写。

下面是PHP的示例代码：

/*********************************************************************************************/
function https_request($url, $data = null)
{
    $curl = curl_init();
    curl_setopt_array($curl, array(
        CURLOPT_URL => $url,
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_ENCODING => '',
        CURLOPT_MAXREDIRS => 10,
        CURLOPT_TIMEOUT => 0,
        CURLOPT_FOLLOWLOCATION => true,
        CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
        CURLOPT_CUSTOMREQUEST => 'POST',
        CURLOPT_POSTFIELDS => json_encode($data,true),
        CURLOPT_HTTPHEADER => array(
            'Content-Type: application/json',
        ),
    ));
    $response = curl_exec($curl);
    curl_close($curl);
    return $response;
}
/*********************************************************************************************/

$ArrayField = [
    'memberid' => 'xxxxxx',
    'orderid' => 'xxxxxx',
    'amount' => "100.12",
    'currency' => 'brl',
    'orderdatetime' => "2020-02-02 12:12:12",
    'notifyurl' => 'http://xxx.xxx.com/notifyurl.php',
];

ksort($ArrayField);  //按照参数名ASCII码从小到大排序
$stringA = urldecode(http_build_query($ArrayField));

$data = [
    'param1' => 'xxxx',
    'param2' => 'xxxx',
    'param3' => 'xxxx',
    'param4' => 'xxxx',
    'param5' => 'xxxx',
 ];

ksort($data);  //按照参数名ASCII码从小到大排序
$stringB = urldecode(http_build_query($data));

$stringC = $stringA.'&'.$stringB;

$md5key = 'xxxxxxxxxxx';  //md5密钥

//拼接密钥后，md5加密后转为大写
$ArrayField["sign"] = strtoupper(md5($stringC.$md5key)); 
$ArrayField["data"] = $data; 
$ArrayField['remarks'] = 'aupay888';

$req = https_request("https://www.ampay.club/daifu/Transfer/index",$ArrayField);

响应参数

响应参数以 json字符串的返回

变量名称	参数名称	参数说明
status	状态	00为提交成功，其它的为提交的失败
msg	说明	如果状态为提交失败，这里会有失败说明
ordermoney	代付金额	代付金额，单位：元
userordernumber	用户代付订单号	商户提交的代付订单号
sysordernumber	系统订单号	系统生成的代付订单号
remarks	扩展字段	原值返回提交时的remarks字段的值

回调通知

通知类型 ：POST

变量名称	参数名称	是否参与签名	参数说明
status	状态	是	00为提交成功，其它的为提交的失败
msg	说明	是	如果状态为提交失败，这里会有失败说明
ordermoney	代付金额	是	代付金额，单位：元
userordernumber	用户代付订单号	是	商户提交的代付订单号
remarks	扩展字段	是	原值返回提交时的remarks字段的值
sign	签名	否	签名算法如下：

如果接收到系统异步回调时，在页面输出“SUCCESS”。

签名算法:

第一步，设（除 sign 以外，值为空的参数也要参与签名）数据为集合M，将集合M内的参数按照参数名ASCII码从小到大排序（字典序），使用URL键值对的格式（即key1=value1&key2=value2…）拼接成字符串 stringA。

第二步，在stringA最后拼接上&key=MD5密钥（签名密钥）得到stringSign（stringA+&key=MD5密钥）字符串，并对stringSign进行MD5运算，不要转大写！不要转大写！不要转大写。

下面是PHP的示例代码：

<?php

$ArrayField = $_POST;

$sign = $ArrayField["sign"];

unset($ArrayField["sign"]);

$md5key = 'XXXXXXXXXXXXXXX';  //密钥

ksort($ArrayField);  //按照参数名ASCII码从小到大排序

$stringA = urldecode(http_build_query($ArrayField));

$signValue = md5($stringA."&key=".$md5key);  //拼接密钥后，md5加密

if($signValue == $sign and $ArrayField["status"] == "00"){
   // 交易成功后的业务逻辑处理
   exit('SUCCESS');   
}

?>

代付查询接口：

请求URL:

https://www.ampay.club/daifu/Transfer/query

请求方式：POST

请求参数：

变量名称	参数名称	是否必填	参数说明
memberid	商户号	是	系统分配的商户编号，例如：10001
userordernumber	商户订单号	是	商户订单号（可为空，但是不能与系统订单同时为空）
sign	md5签名	是	MD5签名

签名算法:

第一步，设（除 sign 以外，值为空的参数也要参与签名）数据为集合M，将集合M内的参数按照参数名ASCII码从小到大排序（字典序），使用URL键值对的格式（即key1=value1&key2=value2…）拼接成字符串 stringA。

第二步，在stringA最后拼接上&key=MD5密钥（签名密钥）得到stringSign（stringA+&key=MD5密钥）字符串，并对stringSign进行MD5运算，不要转大写！不要转大写！不要转大写。

下面是PHP的示例代码：

<?php

function https_request($url, $data = null)
{
    $curl = curl_init();
    curl_setopt($curl, CURLOPT_URL, $url);
    curl_setopt($curl, CURLOPT_SSL_VERIFYPEER, false);
    curl_setopt($curl, CURLOPT_SSL_VERIFYHOST, false);
    if (!empty($data)) {//如果有数据传入数据
        curl_setopt($curl, CURLOPT_POST, 1);//CURLOPT_POST 模拟post请求
        curl_setopt($curl, CURLOPT_POSTFIELDS, $data);//传入数据
    }
    curl_setopt($curl, CURLOPT_RETURNTRANSFER, 1);
    $output = curl_exec($curl);
    curl_close($curl);
    return $output;
}

$ArrayField = [
    'memberid' => 'xxxxxxxxx',  //固定值
    'userordernumber' => 'xxxxxxxxxxxxxx',  //商户订单
];

ksort($ArrayField);  //按照参数名ASCII码从小到大排序

$md5key = 'xxxxxxxxxxxxxx';  //md5密钥

$stringA = urldecode(http_build_query($ArrayField));

$ArrayField["sign"] = md5($stringA."&key=".$md5key);  //拼接密钥后，md5加密后转为大写

$tjurl = 'https://www.ampay.club/daifu/Transfer/query';

$json = https_request($url,$ArrayField);

?>

响应参数

参数名	参数含义	是否参与签名	说明
code	响应状态	是	0 成功，1有错误
status	订单状态	是	00 代付成功, 01处理中，02 未处理，03 已退款， 04 代付失败
msg	返回说明	是	错误说明
userordernumber	用户上传订单号	是	用户上传的唯一订单号,订单申请成功返回
ordermoney	订单金额	是	代付订单金额,订单申请成功返回
remarks	注释	是	用户上传的订单注释,订单申请成功返回
sign	签名		签名

签名算法:

第一步，设（除 sign 以外，值为空的参数也要参与签名）数据为集合M，将集合M内的参数按照参数名ASCII码从小到大排序（字典序），使用URL键值对的格式（即key1=value1&key2=value2…）拼接成字符串 stringA。

第二步，在stringA最后拼接上&key=MD5密钥（签名密钥）得到stringSign（stringA+&key=MD5密钥）字符串，并对stringSign进行MD5运算，不要转大写！不要转大写！不要转大写。

---

附录：

代付 data 详细数据

---

印度代付：

参数名	说明
type	代付类型 ，固定值 ，UPI 或 BANK
accountname	收款人姓名
upinumber	UPI账号
mobile	收款人手机号
email	收款人email
bankname	银行名称
bankcardnumber	银行卡收款账号
ifsc	IFSC号

---

印尼代付：

参数名	说明
bankusername	收款人姓名
bankaccount	银行卡号
bankphone	开户行手机号
email	用户邮箱
bankcode	银行编码 BCA 、BNI 、BRI 、BTN 、CIMB 、DANAMON 、MANDIRI 、ICBC 、MEGA 、MAYBANK 、PERMATA 、PANIN 、OCBC 、SINARMAS 、BJB 、MANDIRI_SYR 、UOB

---

巴西代付

参数名	说明
pixnumber	PIX账号
pixtype	PIX账号类型（CPF、CNPJ、PHONE、EMAIL、EVP）
pixconta	银行账号，不是银行卡号，例如：876543-2
pixagencia	银行机构代码，例如：1234-5
pixbanco	银行代码（3位数字）
name	开户人姓名或公司名称 例如： Tom
bankname	银行名称 例如： Bradesco
cpfnumber	CPF号（格式化后的11位数字）
cnpjnumber	CNPJ号（格式化后的14位数字）
cpfcnpjtype	税号类型，固定值，CPF 或 CNPJ, 为空时默认为CPF
email	邮箱，必填为真实的邮箱地址
telephone	手机号，例如：11-91231-1234
cep	邮编，例如：01419-000

---

南非代付

参数名	说明
name	姓名
bankname	银行名称
bankcardnumber	银行账号

---

墨西哥代付

参数名	说明
bankname	银行名称
bankcode	银行编码（数字）
idnumber	收款人证件号码(curp)
accountname	银行卡开户人姓名
accountno	银行卡账号
phone	手机号

---

越南代付

参数名	说明
cardname	收款人姓名，必须是英文字母，不能输入带符号的越南文姓名
cardno	收款卡号
bankid	银行编号，见下面“越南银行表”

---

尼日利亚代付

参数名	说明
bankaccount	收款卡号
bankcode	银行编号，见下面“尼日利亚银行表”

---

土耳其代付

参数名	说明
email	收款人邮箱
username	收款人姓名
mobileno	收款人手机号
bankcode	银行编号
bankname	银行名称
cardnumber	银行卡号

---

菲律宾代付

参数名	说明
pickupcenter	代付渠道，GCASH(电子钱包)、 PMP(PayMaya Philippines )、BANKRT(instapay银行实时)、BANKNRT(pesonet银行非实时)
accountno	电子钱包或银行卡账号,电子钱包账号为取现人 11位长度之手机号码,必须09开头手机号 示例:09112233888
username	取款人名字(Last name,First name,Middle name) (必填，必须按照格式) 示例：“SANTOS,CRUZ,JUAN”
birthdate	生日：格式 yyyy-MM-dd(必填)
mobilenumber	用户手机号码(必填)
certificatetype	证件类型: SSS ,UMID, TIN ,PASSPORT ,DRIVER_LICENSE,POSTAL,VOTER,COMPANY,UMP。示例:“SSS” (必填)
certificateno	证件号码:“3376672389” (必填)
address	居住地址(必填)。示例:”190 Poblacion Street”
city	城市(必填) 示例：HOUSTON
province	省份(必填) 示例:TEXAS
bankcode	银行编码 （代付渠道为 BANKRT 或 BANKNRT 时必填）

---

秘鲁代付

参数名	说明
account	收款账户
bankcode	扩展类型 [ DNI,PAS, CE, RUC]
identification	扩展编码:对应的各种类型编号
name	收款账户的真实名称
transferaccount	中转账户，与收款账户相关联
accounttype	收款人账号类型[CHECKING,SAVINGS]
bankname	收款银行名称 Banco Continental Banco de Credito Interbank Scotiabank Banco de Comercio Banco Interamericano de Finanzas (BanBif) Banco Pichincha Citibank Banco GNB Banco Santander Banco Azteca Banco Cencosud ICBC PERU BANK Banco de la Nación Caja Cusco Caja Huancayo Caja Maynas Caja Metropolitana Caja Municipal Ica Caja Sullana Caja Tacna Caja Trujillo