get https://api.sandbox.midtrans.com/v2//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 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 | |