API Bkpays Doc
english
  • english
  • 中文
  1. Chile
API Bkpays Doc
english
  • english
  • 中文
  • 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
        • Payout
      • Chile
        • Payment
          POST
        • Payout
          POST
      • 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
  1. Chile

Payout

Developing
POST
/gateway/base/biz
Amount limit: Minimum 1,000 CLP, Maximum 8,000,000 CLP
When a bank account number ends with a letter, it needs to be replaced with 0

Optimization Suggestions#

The beneficiary account number must correctly correspond to the specified bank and account type (users should be guided to input accurate information)
The beneficiary's identity type and identity number must correspond correctly and be accurate
The beneficiary's identity information must match the information of the bank account holder
When the beneficiary bank is Interbank, the recipientCardNo (Código de Cuenta Interbancaria/CCI related to the bank account field "beneficiary account number") is different from the bank account information
The beneficiary name should be the complete full name, not just the last name; providing the full name affects the success rate
When beneficiaryBankType is 3 (RUT account type), the user's payment account number should directly take the first 8 digits of the user's RUT identity ID parameter
When beneficiaryBankType is 3 (RUT account type) AND the user identity type beneficiaryType is 1 (RUT identity type), the system will automatically take the first 8 digits of the beneficiaryId parameter as the user's beneficiary account number
When the user selects Banco Estado (Banco del Estado de Chile), the bank account number will not exceed 12 digits
**Error Code **DescriptionError Field
THE DOCUMENT IS WRONGUser identity information errorbeneficiaryType or beneficiaryId error
INCORRECT ACCOUNT DATAUser entered incorrect bank account informationbeneficiaryAccountNumber or beneficiaryBankCode or beneficiaryBankType error
CREDIT ACCOUNT DOES NOT EXISTUser credit account does not existbeneficiaryAccountNumber or beneficiaryBankCode or beneficiaryBankType error
RESTRICTED CREDIT ACCOUNTRestricted credit accountbeneficiaryAccountNumber error
NON-ACCOUNT HOLDER CUSTOMERAccount holder does not match uploaded identity informationbeneficiaryType or beneficiaryId error
ACCOUNT TYPE DOES NOT ALLOW TRANSFERSAccount type does not allow transfers
BANK OUT OF SERVICESelected bank service is unavailable

Request

Header Params

Body Params application/json

Example
{
    "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"
}

Request Code Samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST '/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"
}'

Responses

🟢200Success
application/json
Body

Example
{
    "data": [
        {
            "orderId": "81"
        },
        {
            "orderId": "39"
        },
        {
            "orderId": "81"
        }
    ],
    "resultCode": "7",
    "errorCode": "35",
    "errorMsg": "in aute aliquip"
}
Modified at 2025-12-05 12:56:10
Previous
Payment
Next
Payment
Built with