API Bkpays Doc
english
  • english
  • 中文
  1. Global universal payment
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
        • 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
        POST
      • Payout
        POST
  • 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. Global universal payment

Payment

Developing
POST
/gateway/base/biz
Regarding the fields of firstname, lastname, email, and phone, it is necessary to provide the user's genuine information. The billingAddress also needs to be filled in; otherwise, it will affect the success rate.

Countries supported by credit card transactions#

TitleDescription
SupportUSD、MXN、EUR、AUD、GBP、JPY、SGD、AED、COP、CLP、INR、CAD
UnSupportAFG、AGO、ATA、BLR、BVT、BFA、CAF、UKR、CUB、COD、UKR、ERI、SWZ、ATF、GNB、GUY、HTI、HMD、IRN、IRQ、UKR、LAO、LBY、UKR、CHN、MMR、ANT、PRK、PSE、RUS、SLE、SOM、SSD、SDN、SYR、TTO、UGA、VUT、VEN、YEM、UKR、ZWE

Trigger risk control and the response error code prompt is as follows:#

Error CodeError MessageFailure Reason
500000Risk rejected: cardNoExcessive transactions using same card number
500000Risk rejected: ipExcessive transactions from same IP address
500000Risk rejected: emailExcessive transactions using same email address
500000Risk rejected: cardNameExcessive transactions using same cardholder name
500000Risk rejected: max amountTransaction amount exceeds limit for card number

Request

Header Params

Body Params application/json

Example
{
    "mchOrderId": "string",
    "amount": "string",
    "firstname": "string",
    "lastname": "string",
    "productinfo": "string",
    "email": "string",
    "phone": "string",
    "callbackUrl": "string",
    "redirectUrl": "string",
    "noPayPage": "string",
    "paymentType": "CARD",
    "currency": "EUR",
    "consumerId": "string",
    "userIp": "string",
    "userAgent": "string",
    "billingAddress": "string",
    "website": "string"
}

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: pay' \
--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",
    "firstname": "string",
    "lastname": "string",
    "productinfo": "string",
    "email": "string",
    "phone": "string",
    "callbackUrl": "string",
    "redirectUrl": "string",
    "noPayPage": "string",
    "paymentType": "CARD",
    "currency": "EUR",
    "consumerId": "string",
    "userIp": "string",
    "userAgent": "string",
    "billingAddress": "string",
    "website": "string"
}'

Responses

🟢200OK
application/json
Body

Example
{
    "data": [
        {
            "orderId": "29",
            "currency": "ut in irure anim",
            "checkoutUrl": "https://flickering-plumber.info/"
        },
        {
            "orderId": "33",
            "currency": "deserunt ut",
            "checkoutUrl": "https://judicious-stock.net/"
        }
    ],
    "success": true,
    "resultCode": "30",
    "errorCode": "56",
    "errorMsg": "ut ullamco commodo"
}
Modified at 2025-12-05 12:56:10
Previous
Payout
Next
Payout
Built with