Query Order

Process

Description:

• Merchant calls this API to retrieve detailed information about an order.

API Information

Method: POST

URL: /b2b/core/api/ext/mm/order/get-order

Request

Main Parameters

No	Parameter	Data Type	Required	Description
1	request_id	String	✅	Request ID
2	request_time	Datetime	✅	Request time. Format: YYYY-MM-DD H:m:s
3	master_merchant_code	String(50)	❌	Master merchant code provided by Baokim
4	sub_merchant_code	String(50)	❌	Sub merchant code provided by Baokim
5	mrc_order_id	String	✅	Merchant order ID

Request Example

{
  "request_id": "7T53RI2IDS5JWAF",
  "request_time": "2023-08-18 10:00:00",
  "master_merchant_code": "BAOKIMMASTERMERCHANT",
  "sub_merchant_code": "BAOKIMSUBMERCHANT",
  "mrc_order_id": 24121706176582
}

Response

Main Parameters

No	Parameter	Data Type	Required	Description
1	code	Integer	✅	Result code
2	message	String	✅	Status message
3	data	Object	✅	Response data

Order Information (data.order)

No	Parameter	Data Type	Required	Description
1	id	Integer	✅	Baokim order ID
2	mrc_order_id	String	✅	Merchant order ID
3	total_amount	Integer	✅	Order amount
4	payment_method	Integer	✅	Payment method
5	status	Integer	✅	Order status (see table below)
6	completed_at	Datetime	✅	Success time
7	created_at	Datetime	✅	Creation time
8	updated_at	Datetime	✅	Last update time

Order Status Information (data.order.status)

Value	Status
0	Created
1	Success
2	Rejected
3	Pending approval
4	Pending FX conversion
5	Processing
6	Pending prepayment
7	Expired
8	Refunding
9	Refunded

Transaction Information (data.transactions)

No	Parameter	Data Type	Required	Description
1	id	Integer	✅	Baokim transaction ID
2	type	Integer	✅	Transaction type: 1 = Payment, 2 = Refund
3	payment_method	Integer	✅	Payment method
4	sub_merchant_fee	Integer	✅	Sub merchant fee
5	master_merchant_fee	Integer	✅	Master merchant fee
6	user_fee	Integer	✅	User fee
7	total_amount	Integer	✅	Total amount customer pays after fees
8	amount	Integer	✅	Amount of sub merchant balance change
9	description	String	✅	Transaction content
10	status	Integer	✅	Status: 0 = Created, 1 = Success, 2 = Failed, 3 = Pending
11	completed_at	Datetime	✅	Success time
12	created_at	Datetime	✅	Creation time
13	updated_at	Datetime	✅	Last update time
14	bnpl	Object	❌	BNPL information (if applicable)
15	installment	Object	❌	Installment information (if applicable)
16	ft_number	String	❌	Bank transaction reference number (FT number), may be null

Transaction BNPL Information (data.transactions.bnpl)

No	Parameter	Data Type	Required	Description
1	payment_per_month	Integer	❌	Monthly payment amount
2	paylater_amount	Integer	❌	Pay later amount
3	down_payment	Integer	❌	Down payment amount
4	provider	Integer	❌	BNPL provider

Transaction Installment Information (data.transactions.installment)

No	Parameter	Data Type	Required	Description
1	card_brand	Integer	❌	Card brand
2	period	Integer	❌	Installment period
3	payment_per_period	Integer	❌	Payment per period
4	bank_code	Integer	❌	Bank code

Response Example

{
  "code": 200,
  "message": "Lấy đơn hàng thành công!",
  "data": {
    "order": {
      "id": 1080000,
      "mrc_order_id": "TT1790310848",
      "total_amount": 3000000,
      "payment_method": 1,
      "status": 1,
      "completed_at": "2026-09-25 11:35:44",
      "created_at": "2026-09-25 11:34:10",
      "updated_at": "2026-09-25 11:35:44"
    },
    "transactions": [
      {
        "id": 10000106,
        "type": 1,
        "payment_method": 3,
        "sub_merchant_fee": 30000,
        "master_merchant_fee": 0,
        "user_fee": 70000,
        "total_amount": 3070000,
        "amount": 2970000,
        "description": null,
        "status": 2,
        "completed_at": null,
        "created_at": "2026-09-25 11:34:53",
        "updated_at": "2026-09-25 11:35:44",
        "bnpl": null,
        "installment": null,
        "ft_number": null
      },
      {
        "id": 10000107,
        "type": 1,
        "payment_method": 1,
        "sub_merchant_fee": 30000,
        "master_merchant_fee": 30000,
        "user_fee": 70000,
        "total_amount": 3070000,
        "amount": 2970000,
        "description": null,
        "status": 1,
        "completed_at": "2026-09-25 11:35:44",
        "created_at": "2026-09-25 11:35:19",
        "updated_at": "2026-09-25 11:35:44",
        "bnpl": null,
        "installment": null,
        "ft_number": null
      }
    ]
  }
}

Error Codes

Error Code	Description
102	Provider error
104	Authentication error
710	Sub merchant does not exist
711	Master merchant does not exist
712	Sub merchant is not active
713	Master merchant is not active
714	Sub merchant does not belong to master merchant