Skip to main content
POST
/
api
/
mapi
/
v1
/
payments
/
open
/
api
/
transfer
转账
curl --request POST \
  --url https://mpgwpre.payallglobal.com/mp-gateway/api/mapi/v1/payments/open/api/transfer \
  --header 'Content-Type: application/json' \
  --header 'signature: <api-key>' \
  --data '
{
  "charset": "UTF-8",
  "version": "<string>",
  "transType": "PAY",
  "accessType": "s2s",
  "signType": "RSA",
  "memberId": "<string>",
  "merchantId": "<string>",
  "currency": "<string>",
  "transferAmount": "<string>",
  "payeeAccountNo": "<string>",
  "payeeAccountName": "<string>",
  "unionFlag": "<string>",
  "publicPrivateFlag": "<string>",
  "useOfFunds": "<string>",
  "payeeBankNumber": "<string>",
  "payeeBankName": "<string>",
  "merchantOrderId": "<string>",
  "notifyUrl": "<string>"
}
'
{
  "isSuccess": true,
  "errCode": "<string>",
  "errMessage": "<string>",
  "status": "<string>",
  "traceId": "<string>",
  "data": {
    "orderId": "<string>",
    "merchantOrderId": "<string>",
    "merchantId": "<string>",
    "currency": "<string>",
    "transferAmount": "<string>",
    "payeeBankNumber": "<string>",
    "payeeBankName": "<string>",
    "payeeAccountNo": "<string>",
    "payeeAccountName": "<string>",
    "notifyUrl": "<string>"
  }
}

Authorizations

​
signature
string
header
required

Example: MIIEpQIBAAKCAQEA...（Base64编码的签名字符串）

加签

加签是开放平台和商户对于交互消息完整性的校验。加签行为主要发生两个部分：

  1. 商户服务器端针对向PayAllGlobal开放平台发送的请求报文进行加签；
  2. PayAllGlobal开放平台针对通知商户的异步消息进行加签。 PayAllGlobal平台要求使用 RSA 私钥进行加签， 使用 RSA 公钥进行验签。 因此，在以上两部分描述的交互中， 存在商户公私钥、PayAllGlobal 公私钥，开发者需要使用商户私钥，对第一部分报文进行加签，使用 PayAllGlobal 公钥对第二部分消息进行验签。

加签规则如下:

使用商户私钥对请求体进行 SHA256withRSA 签名后，再进行 Base64 编码的结果。

  1. 使用 商户私钥对待 request.body 进行签名（SHA256WithRSA 计算原始数据的SHA-256哈希值。 使用私钥对哈希值进行签名，即使用私钥对哈希值进行RSA加密。此时得到的加密结果就是数字签名。）；
Signature signature = Signature.getInstance("SHA256withRSA");
signature.initSign(privateKey);
// 计算 SHA256withRSA 签名时，需要以 utf-8 的编码转换 byte 流，否则可能导致含中文参数的签名计算不正确
signature.update(request.body);
byte[] signedHash = signature.sign();
  1. 将加签内容进行 Base64 编码；
String signature = Base64.getEncoder().encodeToString(signedHash);
  1. 将编码后的内容放在请求头部 signature 参数中。 注意，加签是对 request.body 进行签名，当查询等 request.body 为空时，则无需加签。

Body

application/json
​
charset
string
default:UTF-8
required

交互数据的编码【utf-8】

Example:

"UTF-8"

​
version
string
required

接口版本，当前版本为【2.0.0】,目前只能传2.0.0，不能不传

Example:

"2.0.0"

​
transType
enum<string>
default:PAY
required

交易类型

Available options:
PAY: 消费支付,
CREDIT_CARD: 信用卡支付,
3D_PREAUTH_VOIDS: 3D 预授权撤销,
3D_PREAUTH_COMPLETION: 3D 预授权完成,
REFUND: 退款,
VOIDS: 撤销,
QUERY: 查询,
TRANSFER: 转账,
DOWNLOAD: 文件下载,
REGISTRATION: 商户注册,
FILEUPLOAD: 文件上传,
INQUIRYREGISTRATIONSTATUS: 查询注册状态,
AUTHORIZE: 授权,
CASHIER_PAY: 收银台支付
​
accessType
string
default:s2s
required

接口接入类型，固定为服务端到服务端(s2s)模式

Example:

"s2s"

​
signType
string
default:RSA
required

报文签名类型，当前支持RSA。

Example:

"RSA"

​
memberId
string
required

机构号，商户侧唯一标识

Example:

"2023010558663764"

​
merchantId
string
required

商户号，商户唯一标识

Example:

"2023010558663764"

​
currency
string
required

订单币种ISO4217币种的字母码 eg. USD, CNY, EUR

Example:

"USD"

​
transferAmount
string
required

交易金额

Example:

"100.01"

​
payeeAccountNo
string
required

收款人账户

Example:

"6226660605140231"

​
payeeAccountName
string
required

收款人账户户名

Example:

"张三"

​
unionFlag
string
required

1：行内转账，0：跨行转账

Example:

"0"

​
publicPrivateFlag
string
required

对公对私标识 00:对公 01:对私

Example:

"00"

​
useOfFunds
string
required

资金用途 100个汉字，对方能否看到此用途视收款方银行的支持。

Example:

"供应商付款"

​
payeeBankNumber
string
required

收款人开户行行号

Example:

"102000001"

​
payeeBankName
string
required

收款人开户行名称

Example:

"中国工商银行"

​
merchantOrderId
string
​
notifyUrl
string

异步通知地址

Example:

"https://www.gogole.com"

Response

200 - application/json

OK

​
isSuccess
boolean
required

是否成功，true表示成功，false表示失败

Example:

true

​
errCode
string
required

响应状态码，errCode为00000000表示响应成功，其他状态码表示响应失败。具体系统错误码可以参考系统错误码。

Example:

"00000003"

​
errMessage
string
required

错误消息

Example:

"处理中"

​
status
string
required

订单状态(见补充说明)

Examples:

"PENDING：处理中"

"SUCCESS：成功"

"FAIL：失败"

​
traceId
string
required

请求消息唯一标识。traceId为本次调用产生的流水号，接口调用异常，可以提供此流水号用于排查问题。

Example:

"33fae7b7aed1233f"

​
data
object