# 1 Static VA Creation API

# Describe

  • Merchant Payout - Static VA API

# HTTP Request Information

# Request URL

  • {domain}/open-api/static/payment/code

# Request Method

  • POST

# Request Header

parameter name Is it mandatory type of data description
Content-Type mandatory string application/json

# Request Params

parameter name Is it mandatory type of data length example description
appId mandatory string - - application APPID
param mandatory string - - Parameter Body
sign mandatory string - 45eebd745dcf0b5f6d6f9fcde28cd9fe8116a892 sign

# param

parameter name Is it mandatory type of data length example description
mchOrderId mandatory string 10-32 CCP20220428011068111 Merchant order ID, format: letters + numbers, 10-32 characters
channelCode mandatory string - BNI_VA Channel Code
amount optional long 2000-100000000 50000 Receiving Amount
customerName mandatory string 1-100 - Customer Name
email optional string - - User email Format: email format
mobile optional string - - User phone number
idCardNumber optional string 16-18 - User id card number
notifyUrl mandatory string Merchant Transaction Notification URL
timestamp mandatory long - 1678356680000 Millisecond timestamp
expireTime optional long - 1678356680000 No default expiration time
remark optional string - - Remarks

# channelCode see reference

# Request Body Example

{
  "appId": "abc6e413c37f14f9fabc36fcee8d97c5e",
  "sign": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
  "param": "{\"mchOrderId\":\"TestMchOrderIdP0002\",\"channelCode\":\"BRI_VA\",\"amount\":10000,\"email\":\"test@123.com\",\"mobile\":\"081234567\",\"customerName\":\"test\",\"remark\":\"test payment code\",\"notifyUrl\":\"http://test\",\"timestamp\":1678698098000}"
}

# Response Example

# code see reference

# successful response example

{
  "code": 10000,
  "message": "Success",
  "data": {
    "mchOrderId": "TestMchOrderIdP0002",
    "customerName": "test",
    "expireTime": null,
    "status": "ACTIVE",
    "paymentCode": {
      "channelCode": "BNI_VA",
      "referenceNumber": "8558121202474754"
    }
  }
}

# failed response example

{
  "code": 21000,
  "message": "Service error, please contact administrator",
  "data": null
}