get
https://api.sandbox.midtrans.com/v2//status-1
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
}{
"status_code": "200",
"transaction_id": "78068ef3-e797-4eef-945e-e8516a312916",
"gross_amount": "238429.00",
"currency": "IDR",
"order_id": "test-merchant-order-xyz",
"payment_type": "dana",
"signature_key": "d60dc0a9c7c3cd5c20399d99d56968c241dbaacc26444c2eebc541d3b0fad594cefb50dd866a83089ecba785bd153ee95c03d81a35ccf82689b15d8f57bdbb80",
"transaction_status": "PENDING",
"fraud_status": "accept",
"status_message": "Success, transaction is found",
"merchant_id": "G123456",
"transaction_time": "2025-11-03 12:45:47",
"expiry_time": "2025-11-03 13:00:47",
"actions": [
{
"name": "deeplink-redirect",
"method": "GET",
"url": "https://m.dana.id/transaction_page"
}
}{
"status_code" : "201",
"status_message" : "Success, transaction is found",
"transaction_id" : "78068ef3-e797-4eef-945e-e8516a312916",
"order_id" : "test-merchant-order-xyz",
"payment_type" : "ovo",
"transaction_time" : "2025-11-02 14:39:33",
"transaction_status" : "pending",
"currency": "IDR",
"fraud_status" : "accept",
"signature_key" : "2802a264cb978fbc59f631c68d120cbda8dc853f5dfdc52301c615cf4f14e7a0b09aa...",
"gross_amount" : "30000.00",
"merchant_id": "G123456",
"expiry_time": "2025-11-02 15:44:33",
"payer_phone_number": "081111111111"
}| 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 arecapture: 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 areaccept: 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 | |
| actions | Will be returned only for DANA / ShopeePay payment type with "pending" status. | Object | |
| actions.name | Name of the action that will be inserted on the "actions" object. | String | |
| actions.method | HTTP methods. | String | |
| actions.url | URL that will be returned incase of "pending" status fro deeplink payment | String | |
| payer_phone_number | Customer's phone number that used to create payment request to payment provider. | String | |
| merchant_invoice | Unique identifier for payment provider specific request. | String | |