Get Transaction Status

get https://api.sandbox.midtrans.com/v2/{order_id}/status

Get Transaction Status is triggered to obtain the transaction_status and other details of a specific transaction. Get Status API can be used by both Snap and Core API integration.

Get Transaction Status Method

See sample on the right -- try it yourself!

HTTP Method	Endpoint	Definition
GET	BASE_URL/v2/`{order_id OR transaction_id}`/status	Get the status of transaction.

🚧
If you're using BI SNAP and DANA payment methods, please only use Transaction ID to get status. Otherwise it won't work.

Get Status Transaction Response

{
  "status_code" : "200",
  "status_message" : "Success, Credit Card transaction is successful",
  "transaction_id" : "249fc620-6017-4540-af7c-5a1c25788f46",
  "masked_card" : "48111111-1114",
  "order_id" : "example-1424936368",
  "payment_type" : "credit_card",
  "transaction_time" : "2015-02-26 14:39:33",
  "transaction_status" : "capture",
  "fraud_status" : "accept",
  "approval_code" : "1424936374393",
  "signature_key" : "2802a264cb978fbc59f631c68d120cbda8dc853f5dfdc52301c615cf4f14e7a0b09aa...",
  "bank" : "bni",
  "gross_amount" : "30000.00",
  "channel_response_code": "00",
  "channel_response_message": "Approved",
  "card_type": "credit",
  "payment_option_type": "GOPAY_WALLET",
  "shopeepay_reference_number": "103995032913255264",
  "reference_id": "DL-dduIy7XtGtvxJtNNpOfbAt"
}

{
  "status_code" : "200",
  "status_message" : "Success, refund request is approved by the bank",
  "transaction_id" : "249fc620-6017-4540-af7c-5a1c25788f46",
  "masked_card" : "48111111-1114",
  "order_id" : "example-1424936368",
  "payment_type" : "credit_card",
  "transaction_time" : "2015-02-26 14:39:33",
  "transaction_status" : "partial_refund",
  "fraud_status" : "accept",
  "approval_code" : "1424936374393",
  "signature_key" : "2802a264cb978fbc59f631c68d120cbda8dc853f5dfdc52301c615cf4f14e7a0b09aa...",
  "bank" : "bni",
  "gross_amount" : "30000.00",
  "channel_response_code": "00",
  "channel_response_message": "Approved",
  "card_type": "credit",
  "payment_option_type": "GOPAY_WALLET",
  "refund_amount": "12000.00",
  "refunds": [
    {
      "refund_chargeback_id": 1,
      "refund_amount": "5000.00",
      "created_at": "2015-02-27 00:14:20",
      "reason": "some reason",
      "refund_key": "reference1"
    },
    {
      "refund_chargeback_id": 2,
      "refund_amount": "7000.00",
      "created_at": "2015-02-28 01:23:15",
      "reason": "",
      "refund_key": "reference2"
    },
  ]
}

{
  "status_code" : "200",
  "status_message" : "Success, refund request is approved by the bank",
  "transaction_id" : "249fc620-6017-4540-af7c-5a1c25788f46",
  "masked_card" : "48111111-1114",
  "order_id" : "example-1424936368",
  "payment_type" : "credit_card",
  "transaction_time" : "2015-02-26 14:39:33",
  "transaction_status" : "partial_refund",
  "fraud_status" : "accept",
  "approval_code" : "1424936374393",
  "signature_key" : "2802a264cb978fbc59f631c68d120cbda8dc853f5dfdc52301c615cf4f14e7a0b09aa...",
  "bank" : "bni",
  "gross_amount" : "30000.00",
  "channel_response_code": "00",
  "channel_response_message": "Approved",
  "card_type": "credit",
  "payment_option_type": "GOPAY_WALLET",
  "refund_amount": "12000.00",
  "refunds": [
    {
      "refund_chargeback_id": 1,
      "refund_amount": "5000.00",
      "created_at": "2015-02-27 00:14:20",
      "reason": "some reason",
      "refund_key": "reference1",
      "refund_method": "online",
      "bank_confirmed_at": "2015-02-27 02:30:20"
    },
    {
      "refund_chargeback_id": 2,
      "refund_amount": "7000.00",
      "created_at": "2015-02-28 01:23:15",
      "reason": "",
      "refund_key": "reference2",
      "refund_method": "offline",
      "bank_confirmed_at": "2015-02-27 02:30:20"
    },
  ]
}

{
  "masked_card": "52412500-0127",
  "approval_code": "T12345",
  "bank": "bni",
  "eci": "02",
  "point_balance_amount": "1644.00",
  "point_redeem_amount": 80000,
  "point_redeem_quantity": 26667,
  "channel_response_code": "00",
  "channel_response_message": "Approved",
  "channel": "dragon",
  "three_ds_version": "2",
  "transaction_time": "2023-11-20 07:30:03",
  "custom_field1": "TEST1",
  "custom_field2": "TEST2",
  "gross_amount": "410400.00",
  "currency": "IDR",
  "order_id": "TKP2453912939",
  "payment_type": "credit_card",
  "signature_key": "d60dc0a9c7c3cd5c20399d99d56968c241dbaacc26444c2eebc541d3b0fad594cefb50dd866a83089ecba785bd153ee95c03d81a35ccf82689b15d8f57bdbb80",
  "status_code": "200",
  "transaction_id": "0c8b481d-8b99-4c6a-b735-aec18be92f28",
  "transaction_status": "capture",
  "fraud_status": "accept",
  "expiry_time": "2023-11-20 07:40:03",
  "status_message": "Success, Credit Card transaction is successful",
  "merchant_id": "B200000000000001005476",
  "card_type": "credit",
  "challenge_completion": true
}

JSON Attribute	Description	Type
status_code	Status code of transaction charge result	String
status_message	Description of transaction charge result.	String
transaction_id	Transaction ID given by Midtrans.	String
masked_card	First 8-digit and last 4-digit of customer's credit card number.	String
order_id	Order ID specified by you.	String
payment_type	The payment method used by the customer.	String
transaction_time	Timestamp of transaction in ISO 8601 format. Time Zone: GMT+7.	String
transaction_status	Transaction status after charge credit card transaction. Possible values are `capture`: Transaction is accepted by the bank and ready for settlement. `deny`: transaction is denied by the bank or FDS. `authorize`: Credit card is authorized in pre-authorization feature.	String
fraud_status	Detection result by Fraud Detection System (FDS). Possible values are `accept`: Approved by FDS. `challenge`: Questioned by FDS. Note: Approve transaction to accept it or transaction gets automatically canceled during settlement. `deny`: Denied by FDS. Transaction automatically failed.	String
approval_code	Approval code from payment provider for successful transaction. It can be used for refund.	String
signature_key	Signature key to validate if the notification is originated from Midtrans.	String
bank	The acquiring bank of the transaction.	String
gross_amount	Total amount of transaction in IDR.	String
channel_response_code	Response code from payment channel provider.	String
channel_response_message	Response message from payment channel provider	String
card_type	Type of card used. Possible values are `credit`, `debit`.	String
payment_option_type	Type of payment that is being used, possible values are `GOPAY_WALLET`, `PAY_LATER`, `GO_CICIL`, `GOPAY_COINS` (more possible values will be added once we launch more payment option on Gopay). Only available for Gopay payment type.	String
shopeepay_reference_number	Reference number given by ShopeePay. Only available for ShopeePay payment type and QRIS payment type with acquirer `airpay shopee`.	String
reference_id	Reference ID given by payment provider. Only available for ShopeePay payment type and QRIS payment type with acquirer `airpay shopee`.	String
refund_amount	Cumulative refund amount in `IDR`.	String
refunds	List of refund details related to the transaction. Only available on transaction status `partial_refund` or `refund`.	JSON Array
refund_chargeback_id	Midtrans refund ID.	Long
refund_amount	Amount of the specific refund.	String
created_at	Timestamp of the refund creation.	String
reason	Reason the refund is created.	String
refund_key	Merchant refund reference.	String
refund_method	Refund confirmation method. The value is applied after Midtrans confirm the refund request (1 day after request is made). Possible values are `online`, `offline`.	String
bank_confirmed_at	Timestamp of receipt of refund request confirmation from acquiring bank.	String
point_redeem_amount	Amount redeemed in IDR.	Long
point_redeem_quantity	Point representation of point_redeem_amount.	Long
point_balance_amount	Balance amount in IDR.	String