中国本地钱包-C2C
<p>[TOC]</p>
<h5>简要描述</h5>
<ul>
<li>中国本地钱包C2C 支付宝,微信下单接口，</li>
</ul>
<h5>请求地址</h5>
<ul>
<li><code>/proxy-pay/api/transfer/transaction</code></li>
</ul>
<h5>请求方式</h5>
<ul>
<li>post </li>
<li>application/json </li>
<li>金额单位：元</li>
</ul>
<h5>请求参数说明</h5>
<table>
<thead>
<tr>
<th style="text-align: left;">参数名</th>
<th style="text-align: left;">必选</th>
<th style="text-align: left;">类型</th>
<th>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">merchantOrderNo</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>商户生成的订单号</td>
</tr>
<tr>
<td style="text-align: left;">transferType</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">Number</td>
<td>下发类型：1 银行 2 钱包</td>
</tr>
<tr>
<td style="text-align: left;">transactionType</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>业务类型：C2C</td>
</tr>
<tr>
<td style="text-align: left;">destinationCurrency</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>目的货币码（参照附录 国家货币码）人民币：CNY</td>
</tr>
<tr>
<td style="text-align: left;">destinationAmount</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">Number</td>
<td>目的金额(单位元)</td>
</tr>
<tr>
<td style="text-align: left;">destinationCountryIsoCode</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>目的国家/地区码（参 照附录国家 ISO CODE 例：中国： CHN）</td>
</tr>
<tr>
<td style="text-align: left;">payerId</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">Number</td>
<td>下面的payerId参考值，或下发银行查询接口查询</td>
</tr>
<tr>
<td style="text-align: left;">purposeOfRemittance</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>汇款目的传值：SALARY_PAYMENT 或 FAMILY_SUPPORT</td>
</tr>
<tr>
<td style="text-align: left;">creditPartyIdentifier</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">Object</td>
<td>信用方识别码</td>
</tr>
<tr>
<td style="text-align: left;">-- msisdn</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">Number</td>
<td>手机号</td>
</tr>
<tr>
<td style="text-align: left;">beneficiary</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">Object</td>
<td>受益人</td>
</tr>
<tr>
<td style="text-align: left;">-- firstname</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">String</td>
<td>名</td>
</tr>
<tr>
<td style="text-align: left;">-- lastname</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">String</td>
<td>姓</td>
</tr>
<tr>
<td style="text-align: left;">sender</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">Object</td>
<td>受益人</td>
</tr>
<tr>
<td style="text-align: left;">-- idNumber</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">Number</td>
<td>身份证号</td>
</tr>
<tr>
<td style="text-align: left;">-- dateOfBirth</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">String</td>
<td>生日</td>
</tr>
<tr>
<td style="text-align: left;">-- firstname</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">String</td>
<td>名</td>
</tr>
<tr>
<td style="text-align: left;">-- lastname</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">String</td>
<td>姓</td>
</tr>
<tr>
<td style="text-align: left;">-- code</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">Number</td>
<td>Sender identification code</td>
</tr>
<tr>
<td style="text-align: left;">-- nationalityCountryIsoCode</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>目的国家/地区码</td>
</tr>
<tr>
<td style="text-align: left;">-- countryIsoCode</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>目的国家/地区码</td>
</tr>
<tr>
<td style="text-align: left;">-- address</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>地址</td>
</tr>
<tr>
<td style="text-align: left;">-- idType</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>id类型</td>
</tr>
</tbody>
</table>
<h5>payerId参考值</h5>
<table>
<thead>
<tr>
<th style="text-align: left;">钱包名称</th>
<th style="text-align: left;">测试环境</th>
<th style="text-align: left;">正式环境</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">支付宝</td>
<td style="text-align: left;">3460</td>
<td style="text-align: left;">3541</td>
</tr>
<tr>
<td style="text-align: left;">微信</td>
<td style="text-align: left;">5593</td>
<td style="text-align: left;">5367</td>
</tr>
</tbody>
</table>
<h5>Id type 参考值</h5>
<table>
<thead>
<tr>
<th style="text-align: left;">值</th>
<th style="text-align: left;">描述</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">PASSPORT</td>
<td style="text-align: left;">Passport</td>
</tr>
<tr>
<td style="text-align: left;">NATIONAL_ID</td>
<td style="text-align: left;">National Identification Card</td>
</tr>
<tr>
<td style="text-align: left;">DRIVING_LICENSE</td>
<td style="text-align: left;">Driving License</td>
</tr>
<tr>
<td style="text-align: left;">SOCIAL_SECURITY</td>
<td style="text-align: left;">Social Security Card/Number</td>
</tr>
<tr>
<td style="text-align: left;">TAX_ID</td>
<td style="text-align: left;">Tax Payer Identification Card/Number</td>
</tr>
<tr>
<td style="text-align: left;">SENIOR_CITIZEN_ID</td>
<td style="text-align: left;">Senior Citizen Identification Card</td>
</tr>
<tr>
<td style="text-align: left;">BIRTH_CERTIFICATE</td>
<td style="text-align: left;">Birth Certificate</td>
</tr>
<tr>
<td style="text-align: left;">VILLAGE_ELDER_ID</td>
<td style="text-align: left;">Village Elder Identification Card</td>
</tr>
<tr>
<td style="text-align: left;">RESIDENT_CARD</td>
<td style="text-align: left;">Permanent Residency Identification Card</td>
</tr>
<tr>
<td style="text-align: left;">ALIEN_REGISTRATION</td>
<td style="text-align: left;">Alien Registration Certificate/Card</td>
</tr>
<tr>
<td style="text-align: left;">PAN_CARD</td>
<td style="text-align: left;">PAN Card</td>
</tr>
<tr>
<td style="text-align: left;">VOTERS_ID</td>
<td style="text-align: left;">Voter’s Identification Card</td>
</tr>
<tr>
<td style="text-align: left;">HEALTH_CARD</td>
<td style="text-align: left;">Health Insurance Card/Number</td>
</tr>
<tr>
<td style="text-align: left;">EMPLOYER_ID</td>
<td style="text-align: left;">Employer Identification Card</td>
</tr>
<tr>
<td style="text-align: left;">OTHER</td>
<td style="text-align: left;">Others not listed</td>
</tr>
</tbody>
</table>
<h5>微信请求示例</h5>
<pre><code> {
&quot;merchantOrderNo&quot;:&quot;3757575751&quot;,
&quot;transferType&quot;:&quot;2&quot;,
&quot;transactionType&quot;:&quot;C2C&quot;,
&quot;destinationCurrency&quot;:&quot;CNY&quot;,
&quot;destinationAmount&quot;:&quot;100&quot;,
&quot;destinationCountryIsoCode&quot;:&quot;CHN&quot;,
&quot;payerId&quot;:&quot;5593&quot;,
&quot;purposeOfRemittance&quot;:&quot;SALARY_PAYMENT&quot;,
&quot;creditPartyIdentifier&quot;:{
&quot;msisdn&quot;:&quot;+638275017100&quot;
},
&quot;beneficiary&quot;:{
&quot;firstname&quot;:&quot;Chang&quot;,
&quot;lastname&quot;: &quot;James&quot;
},
&quot;sender&quot; : {
&quot;idNumber&quot; : &quot;191829182CT&quot;,
&quot;dateOfBirth&quot; : &quot;1980-12-19&quot;,
&quot;lastname&quot; : &quot;David&quot;,
&quot;code&quot; : &quot;code placeholder...&quot;,
&quot;nationalityCountryIsoCode&quot; : &quot;GBR&quot;,
&quot;firstname&quot; : &quot;Ruben&quot;,
&quot;countryIsoCode&quot; : &quot;GBR&quot;
}
}</code></pre>
<h5>curl 用例</h5>
<pre><code>curl --location 'http://uat.proxy.pay.api.clipspay.com/proxy-pay/api/transfer/transaction' \
--header 'X-CSP-AppId: 1681548713353' \
--header 'X-CSP-Signature: nFbgl6Xy34RckRFY5B41zEVSCa6FmiINNeDvHosg6x8=' \
--header 'X-CSP-RequestTime: 12345678' \
--header 'X-CSP-RequestNo: 1687776591000' \
--header 'Content-Type: application/json' \
--data ' {
&quot;merchantOrderNo&quot;:&quot;3757575751&quot;,
&quot;transferType&quot;:&quot;2&quot;,
&quot;transactionType&quot;:&quot;C2C&quot;,
&quot;destinationCurrency&quot;:&quot;CNY&quot;,
&quot;destinationAmount&quot;:&quot;100&quot;,
&quot;destinationCountryIsoCode&quot;:&quot;CHN&quot;,
&quot;payerId&quot;:&quot;5593&quot;,
&quot;creditPartyIdentifier&quot;:{
&quot;msisdn&quot;:&quot;+638275017100&quot;
},
&quot;beneficiary&quot;:{
&quot;firstname&quot;:&quot;Chang&quot;,
&quot;lastname&quot;: &quot;James&quot;
},
&quot;sender&quot; : {
&quot;idNumber&quot; : &quot;191829182CT&quot;,
&quot;dateOfBirth&quot; : &quot;1980-12-19&quot;,
&quot;lastname&quot; : &quot;David&quot;,
&quot;code&quot; : &quot;code placeholder...&quot;,
&quot;nationalityCountryIsoCode&quot; : &quot;GBR&quot;,
&quot;firstname&quot; : &quot;Ruben&quot;,
&quot;countryIsoCode&quot; : &quot;GBR&quot;
}
}'
</code></pre>
<h5>支付宝请求示例</h5>
<pre><code> {
&quot;merchantOrderNo&quot;:&quot;3757575751&quot;,
&quot;transferType&quot;:&quot;2&quot;,
&quot;transactionType&quot;:&quot;C2C&quot;,
&quot;destinationCurrency&quot;:&quot;CNY&quot;,
&quot;destinationAmount&quot;:&quot;100&quot;,
&quot;destinationCountryIsoCode&quot;:&quot;CHN&quot;,
&quot;purposeOfRemittance&quot;:&quot;SALARY_PAYMENT&quot;,
&quot;payerId&quot;:&quot;3460&quot;,
&quot;creditPartyIdentifier&quot;:{
&quot;msisdn&quot;:&quot;+638275017100&quot;
},
&quot;beneficiary&quot;:{
&quot;firstname&quot;:&quot;Chang&quot;,
&quot;lastname&quot;: &quot;James&quot;
},
&quot;sender&quot; : {
&quot;idNumber&quot; : &quot;191829182CT&quot;,
&quot;dateOfBirth&quot; : &quot;1980-12-19&quot;,
&quot;lastname&quot; : &quot;Liam&quot;,
&quot;code&quot; : &quot;code placeholder...&quot;,
&quot;idType&quot; : &quot;PASSPORT&quot;,
&quot;firstname&quot; : &quot;David&quot;,
&quot;address&quot; : &quot;12B Baker Street&quot;,
&quot;countryIsoCode&quot; : &quot;GBR&quot;
}
}</code></pre>
<h5>返回参数说明</h5>
<table>
<thead>
<tr>
<th style="text-align: left;">参数名</th>
<th style="text-align: left;">类型</th>
<th>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">code</td>
<td style="text-align: left;">int</td>
<td>返回码</td>
</tr>
<tr>
<td style="text-align: left;">msg</td>
<td style="text-align: left;">String</td>
<td>提示信息</td>
</tr>
<tr>
<td style="text-align: left;">data</td>
<td style="text-align: left;">Object</td>
<td>数据对象</td>
</tr>
<tr>
<td style="text-align: left;">-- orderNo</td>
<td style="text-align: left;">String</td>
<td>平台订单号</td>
</tr>
<tr>
<td style="text-align: left;">-- merchantOrderNo</td>
<td style="text-align: left;">String</td>
<td>商户订单号</td>
</tr>
<tr>
<td style="text-align: left;">-- merchantNo</td>
<td style="text-align: left;">String</td>
<td>商户号</td>
</tr>
<tr>
<td style="text-align: left;">-- destinationAmount</td>
<td style="text-align: left;">Number</td>
<td>目的金额</td>
</tr>
<tr>
<td style="text-align: left;">-- destinationCurrency</td>
<td style="text-align: left;">String</td>
<td>目的货币</td>
</tr>
<tr>
<td style="text-align: left;">-- destinationCountryIsoCode</td>
<td style="text-align: left;">String</td>
<td>目的国家/地区码</td>
</tr>
<tr>
<td style="text-align: left;">-- merchantSettlementAmount</td>
<td style="text-align: left;">Number</td>
<td>结算金额</td>
</tr>
<tr>
<td style="text-align: left;">-- merchantSettlementCurrency</td>
<td style="text-align: left;">String</td>
<td>结算货币</td>
</tr>
<tr>
<td style="text-align: left;">-- totalFeeAmount</td>
<td style="text-align: left;">Number</td>
<td>手续费金额</td>
</tr>
<tr>
<td style="text-align: left;">-- totalRate</td>
<td style="text-align: left;">Number</td>
<td>汇率</td>
</tr>
<tr>
<td style="text-align: left;">-- payStatus</td>
<td style="text-align: left;">Number</td>
<td>下发状态 0 下发失败 1 待下发 2 已下 发 3 已到账</td>
</tr>
<tr>
<td style="text-align: left;">-- orderStatus</td>
<td style="text-align: left;">Number</td>
<td>订单状态 0 已取消 1 审核中 2 处理中 3 已完成</td>
</tr>
<tr>
<td style="text-align: left;">-- appId</td>
<td style="text-align: left;">Number</td>
<td>应用 ID</td>
</tr>
<tr>
<td style="text-align: left;">-- payerId</td>
<td style="text-align: left;">String</td>
<td>银行或钱包 ID</td>
</tr>
<tr>
<td style="text-align: left;">-- payerName</td>
<td style="text-align: left;">String</td>
<td>银行或钱包名称</td>
</tr>
<tr>
<td style="text-align: left;">-- transferType</td>
<td style="text-align: left;">Number</td>
<td>下发类型</td>
</tr>
<tr>
<td style="text-align: left;">-- payMessage</td>
<td style="text-align: left;">String</td>
<td>下发信息</td>
</tr>
<tr>
<td style="text-align: left;">-- creditPartyIdentifie</td>
<td style="text-align: left;">Object</td>
<td>信用方识别码</td>
</tr>
<tr>
<td style="text-align: left;">-- -- accountType</td>
<td style="text-align: left;">String</td>
<td>账户类型</td>
</tr>
<tr>
<td style="text-align: left;">-- -- routingCode</td>
<td style="text-align: left;">String</td>
<td>银行路由码</td>
</tr>
<tr>
<td style="text-align: left;">-- -- bankAccountNumber</td>
<td style="text-align: left;">Number</td>
<td>银行卡卡号</td>
</tr>
<tr>
<td style="text-align: left;">-- -- branchNumber</td>
<td style="text-align: left;">Number</td>
<td>银行卡卡号</td>
</tr>
<tr>
<td style="text-align: left;">-- -- msisdn</td>
<td style="text-align: left;">Number</td>
<td>手机号</td>
</tr>
<tr>
<td style="text-align: left;">-- beneficiary</td>
<td style="text-align: left;">Object</td>
<td>受益人</td>
</tr>
<tr>
<td style="text-align: left;">-- -- lastname</td>
<td style="text-align: left;">String</td>
<td>姓</td>
</tr>
<tr>
<td style="text-align: left;">-- -- firstname</td>
<td style="text-align: left;">String</td>
<td>名</td>
</tr>
<tr>
<td style="text-align: left;">-- -- msisdn</td>
<td style="text-align: left;">Number</td>
<td>手机号</td>
</tr>
<tr>
<td style="text-align: left;">-- -- city</td>
<td style="text-align: left;">String</td>
<td>城市</td>
</tr>
<tr>
<td style="text-align: left;">-- -- provinceState</td>
<td style="text-align: left;">String</td>
<td>省</td>
</tr>
<tr>
<td style="text-align: left;">-- -- address</td>
<td style="text-align: left;">String</td>
<td>地址</td>
</tr>
<tr>
<td style="text-align: left;">-- -- postalCode</td>
<td style="text-align: left;">String</td>
<td>邮编</td>
</tr>
<tr>
<td style="text-align: left;">-- -- nationalityCountryIsoCode</td>
<td style="text-align: left;">String</td>
<td></td>
</tr>
<tr>
<td style="text-align: left;">-- -- countryIsoCode</td>
<td style="text-align: left;">String</td>
<td>国家/地区码</td>
</tr>
<tr>
<td style="text-align: left;">-- -- idNumber</td>
<td style="text-align: left;">Number</td>
<td>身份证号</td>
</tr>
<tr>
<td style="text-align: left;">-- sender</td>
<td style="text-align: left;">Object</td>
<td>付款人</td>
</tr>
<tr>
<td style="text-align: left;">-- -- lastname</td>
<td style="text-align: left;">String</td>
<td>姓</td>
</tr>
<tr>
<td style="text-align: left;">-- -- firstname</td>
<td style="text-align: left;">String</td>
<td>名</td>
</tr>
<tr>
<td style="text-align: left;">-- -- idNumbe</td>
<td style="text-align: left;">Number</td>
<td>身份证号</td>
</tr>
<tr>
<td style="text-align: left;">-- -- dateOfBirth</td>
<td style="text-align: left;">String</td>
<td>生日</td>
</tr>
<tr>
<td style="text-align: left;">-- -- code</td>
<td style="text-align: left;">String</td>
<td>省</td>
</tr>
<tr>
<td style="text-align: left;">-- -- nationalityCountryIsoCode</td>
<td style="text-align: left;">String</td>
<td>国家/地区码</td>
</tr>
<tr>
<td style="text-align: left;">-- -- countryIsoCode</td>
<td style="text-align: left;">String</td>
<td>国家/地区码</td>
</tr>
<tr>
<td style="text-align: left;">-- -- idType</td>
<td style="text-align: left;">String</td>
<td>id类型</td>
</tr>
<tr>
<td style="text-align: left;">-- -- address</td>
<td style="text-align: left;">String</td>
<td>地址</td>
</tr>
<tr>
<td style="text-align: left;">-- createDate</td>
<td style="text-align: left;">String</td>
<td>创建时间</td>
</tr>
</tbody>
</table>
<h5>返回示例</h5>
<pre><code> {
&quot;code&quot;: 0,
&quot;msg&quot;: &quot;success&quot;,
&quot;data&quot;: {
&quot;orderNo&quot;: &quot;1685503680748&quot;,
&quot;merchantOrderNo&quot;: &quot;1685503724888&quot;,
&quot;merchantNo&quot;: &quot;1683774097725&quot;,
&quot;destinationAmount&quot;: 1.00,
&quot;destinationCurrency&quot;: &quot;PHP&quot;,
&quot;destinationCountryIsoCode&quot;: &quot;PHL&quot;,
&quot;merchantSettlementAmount&quot;: 0.08,
&quot;merchantSettlementCurrency&quot;: &quot;USD&quot;,
&quot;totalFeeAmount&quot;: 0.06,
&quot;totalRate&quot;: null,
&quot;payStatus&quot;: 3,
&quot;orderStatus&quot;: 3,
&quot;appId&quot;: &quot;1683788923144&quot;,
&quot;payerId&quot;: &quot;2853&quot;,
&quot;payerName&quot;: &quot;GCash&quot;,
&quot;transferType&quot;: 2,
&quot;payMessage&quot;: null,
&quot;creditPartyIdentifier&quot;: {
&quot;accountType&quot;: null,
&quot;routingCode&quot;: null,
&quot;bankAccountNumber&quot;: null,
&quot;branchNumber&quot;: null,
&quot;msisdn&quot;: &quot;+947641259100&quot;
},
&quot;beneficiary&quot;: {
&quot;lastname&quot;: &quot;.&quot;,
&quot;firstname&quot;: &quot;Ruben Duncan&quot;,
&quot;msisdn&quot;: null,
&quot;city&quot;: null,
&quot;provinceState&quot;: null,
&quot;address&quot;: null,
&quot;postalCode&quot;: null,
&quot;nationalityCountryIsoCode&quot;: null,
&quot;countryIsoCode&quot;: null,
&quot;idNumber&quot;: null
},
&quot;sender&quot; : {
&quot;id_number&quot; : &quot;191829182CT&quot;,
&quot;date_of_birth&quot; : &quot;1980-12-19&quot;,
&quot;lastname&quot; : &quot;Liam&quot;,
&quot;code&quot; : &quot;code placeholder...&quot;,
&quot;id_type&quot; : &quot;PASSPORT&quot;,
&quot;firstname&quot; : &quot;David&quot;,
&quot;address&quot; : &quot;12B Baker Street&quot;,
&quot;nationalityCountryIsoCode&quot; : &quot;GBR&quot;,
&quot;country_iso_code&quot; : &quot;GBR&quot;
},
&quot;createDate&quot;: &quot;2023-05-31 11:27:08&quot;
}
}</code></pre>
<ul>
<li>更多返回错误代码请看首页的错误代码描述</li>
</ul>