API M2Square
🇺🇸 English
  • 🇺🇸 English
  • 🇨🇳中文
Home
Official WebsiteContract
Home
Official WebsiteContract
🇺🇸 English
  • 🇺🇸 English
  • 🇨🇳中文
🇺🇸 English
  • 🇺🇸 English
  • 🇨🇳中文
  1. Peru
  • Development Guide
    • Development Integration Guidelines
    • API Request Structure Definition
    • APIs Signature
    • Postman And SDK
    • APIs WebHook
    • Order Status
    • APIs Error Code List
    • PCI Compliance
    • Payment Process Explanation
  • Transaction APIs
    • North America
      • USA
        • Payment
        • Payout
      • Mexico
        • Payment
        • Payout
    • South America
      • Brazil
        • Payment
        • Payout
      • Colombia
        • Payment
        • Payout
      • Ecuador
        • Payment
        • Payout
      • Argentina
        • Payment
        • Payout
      • Peru
        • Payment
          POST
        • Payout
          POST
      • Chile
        • Payment
        • Payout
      • Venezuela
        • Payment
        • Payout
    • Asia
      • Indonesia
        • Payment
        • Payout
      • Philippines
        • Payment
        • Payout
      • Thailand
        • Payment
        • Payout
      • Malaysia
        • 收款
        • 出款
      • Bengal
        • Payment
        • Payout
      • India
        • Payment
        • Payout
      • Pakistan
        • Payment
        • Payout
    • Europe
      • Russia
        • Payment
        • Payout
    • Mid East
      • United Arab Emirates
        • Payment
        • Payout
      • Turkey
        • Payment
        • Payout
    • Africa
      • Kenya
        • Payment
        • Payout
      • Nigeria
        • Payment
        • Payout
      • South Africa
        • Payment
        • Payout
      • Tanzania
        • Payment
        • Payout
    • Global universal payment
      • Payment
      • Payout
  • Common APIs
    • Payout Voucher Query
      POST
    • Account Balance Query
      POST
    • Order Status Query
      POST
  • Payment of Video Case
    • Video Case
    • Payment method Logo
  • Dashboard Guide
    • Bind Google Authenticator 2FA
  • Schemas
    • Payment Common Request Body
    • Payment Common Response Body
    • Payout Common Request Body
    • Payout Common Response Body
Home
Official WebsiteContract
Home
Official WebsiteContract
🇺🇸 English
  • 🇺🇸 English
  • 🇨🇳中文
🇺🇸 English
  • 🇺🇸 English
  • 🇨🇳中文
  1. Peru

Payout

Developing
POST
/gateway/base/biz
金额最低1PEN 最大40000PEN
优化建议
1.
出款账户信息(beneficiaryAccountNumber)对应的银行(beneficiaryBankCode)和账户类型(beneficiaryBankType)一定要正确(可以引导用户一定输入正确的用户信息)
2.
出款人的身份类型(beneficiaryType)和身份号(beneficiaryId)一定要对应并且正确
3.
出款人的身份信息(beneficiaryId)一定和银行账户所属人的信息一致
4.
当用户收款银行是Interbank 时recipientCardNo(Código de Cuenta Interbancaria (CCI)与银行账户(字段“收款人账号”)相关) 银行账户信息和recipientCardNo是不相同的
5.
用户名字(beneficiaryName)一定要输入完整的用户名
6.
当用户选择四大行出款时CCI 号码可以不用填写四大行包括(Banco Continental,Banco de Credito,Interbank,Scotiabank),非四大行需要填CCI号码,注意Banco Continental 其实就是BBVA,Banco de Credito 就是BCP
您可以在 https://www.viabcp.com/conoce-tu-cci 或目的地银行的网站上查看 CCI
您可以在 https://bancaporinternet.bn.com.pe/CCIConsulta/consulta.do 查找 Banco de la Nación CC 号码
错误码错误描述错误字段
NON-ACCOUNT HOLDER CUSTOMER账户所属人和上传身份信息不一致beneficiaryType或者beneficiaryId 错误
CREDIT ACCOUNT CANCELLED用户填写的银行账户已取消beneficiaryAccountNumber 错误
CREDIT ACCOUNT DOES NOT EXIST用户填写的银行账户不存在beneficiaryAccountNumber或者beneficiaryBankCode或者beneficiaryBankType 错误
INCORRECT ACCOUNT INFORMATION账户信息不正确beneficiaryAccountNumber或者beneficiaryBankCode或者beneficiaryBankType 错误
THE DOCUMENT IS WRONG用户身份信息错误beneficiaryType或者beneficiaryId 错误
秘鲁银行账户规则
银行名称校验规则
BBVA (Banco Continental)18位或20位
EX: 001106660100012345 (18位)
EX: 00110666010001234512 (20位)
Interbank13位
BCP (Banco de Credito)活期账户13
储蓄账户:14位
Scotiabank10位 Example:0037651234 (10 digits: 3 agency + 7 account)
非四大行使用20位的CCI账号
Example:00219400254640654321 (20 digits)

Request

Header Params

Body Params application/json

Examples

Responses

🟢200Success
application/json
Body

Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'http://prod-cn.your-api-server.com/gateway/base/biz' \
--header 'method: payOut' \
--header 'signType: SHA512' \
--header 'serviceName: api.pay' \
--header 'mchId: 1416010331032883200' \
--header 'timestamp: 1631671670' \
--header 'sign: 32554324534545432543' \
--header 'Content-Type: application/json' \
--data-raw '{
    "mchOrderId": "string",
    "amount": "string",
    "currency": "string",
    "purpose": "string",
    "beneficiaryName": "string",
    "beneficiaryEmail": "string",
    "beneficiaryMobile": "string",
    "beneficiaryAccountNumber": "string",
    "callbackUrl": "string",
    "paymentType": "NET_BANKING",
    "beneficiaryType": "1",
    "beneficiaryId": "string",
    "beneficiaryBankType": "0",
    "beneficiaryBankCode": "001",
    "recipientCardNo": "string"
}'
Response Response Example
{
    "resultCode": "96",
    "errorCode": "50",
    "errorMsg": "dolor reprehenderit in esse",
    "data": {
        "orderId": "1"
    }
}
Modified at 2025-10-27 12:33:01
Previous
Payment
Next
Payment
Built with