B scan C - create new

POST {{base_url}}/api/v1/bscanc/orders

Create Order

API

URL/api/v1/bscanc/orders
MethodPOST
Content-Typeapplication/json

Request parameter

Body parameter
nameLocationTypesrequiredinstruction
merchantorderidbodystringYesThe unique order number used by the merchant
amountbodynumberYesHow much to charge. add 00 for decimal.Example 150.50 THB amount =15050
auth_codebodystringYesThe Authentication code generated from eWallet of the consumer
notebodystringNoorder notes
timestampbodystringYesTimestamp
midbodystringNoThe merchant ID of this order is only valid when there are multiple sub-merchants under the same account.
providerbodystringNoPayment gateway, optional values ('th','ph','my')
channelbodystringYesPayment Merchant support. Value range:

alipay: Alipay Wallet.
wechat: Wechat Wallet.
linepay: Rabbit LINE Pay Wallet.
airpay: Shopeepay Wallet.
truemoney: TrueMoney Wallet.
device_idbodystringNoterminal id from which the request is sent, assigned by merchant.
operator_idbodystringNooperator_id number at cashier, using for merchant have muti level account or Cashier. For more information please check at Muti level account or Cashier
signaturebodystringYesRequest signature
Request body example
{
    "mid":"mch38339",
    "amount": 100,
    "auth_code":"00003030015998",
    "channel": "truemoney",
    "merchant_order_id": "bscanc_truemoney",
    "note": "string",
    "signature": "5BB4D52997FA2B96985EFED7C78335E8171778F40D521F007356EAE62A367CBD",
    "timestamp": "1629189071"
}

Response result

  • When the error_code is SUCCESS, the order creation is successful, and the interface returns the order details

  • reference is the payment address or the order number of the corresponding payment channel

Successful response example
{
    "cleared": false,
    "channel": "truemoney",
    "status": "Paid",
    "note": "string",
    "merchant_order_id": "bscanc_truemoney2",
    "signature": "BFEB0F4C28DDDB3591E74F6E83238BD4B3BD521F9870D00EA534C8C52EF20744",
    "timestamp": "1629189071",
    "amount": 100,
    "id": "288",
    "force_clear": false,
    "api_name": "BscanC",
    "currency": "THB",
    "order_type": "Sale",
    "locked": false,
    "error_message": "Successful",
    "gateway_order_id": "snut288",
    "error_code": "SUCCESS",
    "acquirer": "Ksher",
    "acquirer_order_id": "90020210817191616813118",
    "log_entry_url": "https://snut.vip.ksher.net/web#action=153&view_type=form&model=rest.log&id=1156"
}
Response failure example
{
    "cleared": false,
    "signature": "93F54BF4D6282DDECED74209E8146921AF612322692B855755A88CF745562E27",
    "force_clear": false,
    "locked": false,
    "error_message": "Duplicated Order ID",
    "error_code": "DUPLICATED",
    "log_entry_url": "https://snut.vip.ksher.net/web#action=153&view_type=form&model=rest.log&id=1154"
}

Expire time QR on C scan B API

BBL PromptPay
  • can setup time wallet -> No
  • expire_time min -> can't setup
  • expire_time max -> can't setup
  • default time expiretime, If merchant leave value expiretime -> never expire
SCB PromptPay
  • can setup time wallet -> Yes, at expire_time
  • expire_time min -> 0
  • expire_time max -> unlimited depend on customer
  • default time expiretime, If merchant leave value expiretime -> 1 day
Truemoney
  • can setup time wallet -> Yes, at tmnexpiretime
  • expire_time min -> 0
  • expire_time max -> unlimited depend on customer
  • default time expiretime, If merchant leave value tmnexpire_time -> 1 day
Alipay
  • can setup time wallet -> No
  • expire_time min -> can't setup
  • expire_time max -> can't setup
  • default time expiretime, If merchant leave value expiretime -> 3 hours
Wechat
  • can setup time wallet -> No
  • expire_time min -> can't setup
  • expire_time max -> can't setup
  • default time expiretime, If merchant leave value expiretime -> 2 hours
Shopeepay
  • can setup time wallet -> No
  • expire_time min -> can't setup
  • expire_time max -> can't setup
  • default time expiretime, If merchant leave value expiretime -> 1 month

Request Body

{"mid"=>"mch38026", "amount"=>100, "auth_code"=>"APTH0529984091149333", "channel"=>"airpay", "merchant_order_id"=>"bscanc_20220526112700", "note"=>"string", "signature"=>"{{signature}}", "timestamp"=>"1629189071"}