API References
Create AccountSubmit FeedbackAI Assist (BETA)

BSI Virtual Account

BSI Virtual Account is a bank transfer method facilitated by Bank BSI. Payment can be made only through BYOND by BSI mobile application.

Steps to integrate :

  1. Send the charge API request to Midtrans.
  2. Redirect your customer back to your page by configuring Finish URL in Midtrans's Dashboard > Snap Preferences or via API Request.
  3. Handle notifications.

Open amount and close amount VA has the exact same API contract - by default close amount VA type is activated for you. If you want to activate open amount VA, contact Midtrans support or your sales PIC for further assistance.

By default, default expiry time for bank transfer is 24 hours unless specified by merchant (min 20s, max 180 days).



Sample JSON Request Body


{
  "transaction_details": {
    "order_id": "ORDER-101",
    "gross_amount": 10000
  },
  "item_details": [{
    "id": "ITEM1",
    "price": 10000,
    "quantity": 1,
    "name": "Midtrans Bear",
    "brand": "Midtrans",
    "category": "Toys",
    "merchant_name": "Midtrans"
  }],
  "customer_details": {
    "first_name": "TEST",
    "last_name": "MIDTRANSER",
    "email": "[email protected]",
    "phone": "+628123456"
  },
  "enabled_payments": ["bsi_va"],
  "bsi_va": {
    "va_number": "12345678"
  }
}
ParameterDescription
transaction_details
Transaction Details Object (required)		Unique transaction ID
item_details
Item Details Object (optional)		Shopping item details will be paid by customer
customer_details
Customer Details Object (optional)		Details of the customer
enabled_payments
Array (optional)		Set what payment method to show in Snap's payment list. Value: bsi_va
bsi_va
BSI Virtual Account (optional)		BSI Virtual Account payment options

For a full list of request body parameters please refer to the Request Body (JSON Parameter) section


Note: Please also refer to the Custom VA Number section if you're looking to define your own VA number for your customers.

API Operations for BSI VA

Danamon VA supports two API operations: Get Status, and Cancel. These operations use the transaction_id as the identifier to process the payment. The transaction_id can be obtained from the HTTP notification (Webhook).

Get Status API

Use this API to check the current status of a transaction.

curl --location 'https://api.sandbox.midtrans.com/v2/{transaction_id}/status' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--header 'transaction-source: SNAP_API' \
--header 'Authorization: Key'

{
    "status_code": "200",
    "transaction_id": "A120240830074017NP16XMU4JTID",
    "gross_amount": "20000.00",
    "currency": "IDR",
    "order_id": "sample-store-1725003597",
    "payment_type": "dana",
    "signature_key": "1b1f71e1b1b525e6c58c09f845c8b6b6d911ddfce34820bc52a9e6e5cf654a5f40639d6e33e510a2e9095c234b122becbe1ad919da2dedea3a4343f7905656d2",
    "transaction_status": "settlement",
    "fraud_status": "accept",
    "status_message": "Success, transaction is found",
    "merchant_id": "M007743",
    "transaction_time": "2024-08-30 14:40:17",
    "settlement_time": "2024-08-30 14:40:21",
    "expiry_time": "2024-08-30 14:55:17"
}

Cancel API

Use this API to cancel a transaction.

curl --location --request POST 'https://api.sandbox.midtrans.com/v2/{transaction_id}/cancel' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--header 'transaction-source: SNAP_API' \
--header 'Authorization: Key'

{
    "status_code": "200",
    "status_message": "Success, transaction is canceled",
    "merchant_id": "G379181825",
    "gross_amount": "20000.00",
    "currency": "IDR",
    "payment_type": "dana",
    "transaction_status": "cancel",
    "fraud_status": "accept",
    "transaction_time": "2024-08-30 14:55:45"
}

🚧

API Usage Notes

  • The transaction_id is the key identifier for all API operations with BSI VA. Ensure you retrieve and store this ID from the HTTP notification.
  • Replace {transaction_id} in the API endpoints with the actual transaction ID received from the HTTP notification.
  • Always check the status_code and status_message in the response to confirm the success of your API call.