---
updatedAt: 2025-09-18T11:22:54.000Z
agentTools:
  projectIndex: https://docs.portone.cloud/llms.txt
---

# Get Transaction Status

Fetch the status of the Transaction. Status will be either "Success/ Failed or Pending". Refer PortOne docs for additional details.

[![Run in Postman](https://run.pstmn.io/button.svg)](https://god.gw.postman.com/run-collection/30792494-e1634546-0982-450f-bb35-c084a67d50ba?action=collection%2Ffork\&source=rip_markdown\&collection-url=entityId%3D30792494-e1634546-0982-450f-bb35-c084a67d50ba%26entityType%3Dcollection%26workspaceId%3D96671d7c-ff15-4629-93be-0afd6974acef)

# OpenAPI definition

```json
{
  "openapi": "3.0.0",
  "info": {
    "title": "Payment APIs",
    "version": "1.0.0"
  },
  "servers": [
    {
      "url": "https://api.portone.cloud"
    }
  ],
  "paths": {
    "/api/transaction/{merchantOrderRef}/status": {
      "get": {
        "tags": [
          "Payment APIs"
        ],
        "summary": "Get Transaction Status",
        "description": "Fetch the status of the Transaction. Status will be either \"Success/ Failed or Pending\". Refer PortOne docs for additional details.",
        "parameters": [
          {
            "name": "X-Portone-Client-Key",
            "in": "header",
            "schema": {
              "type": "string"
            },
            "example": "ShgshjhgHdg"
          },
          {
            "name": "Authorization",
            "in": "header",
            "description": "The `Authorization` header is used to include the JWT for authenticating API requests; learn how to generate the token <a href=\"/docs/jwt-authentication\" target=\"_blank\">in this guide</a>",
            "schema": {
              "type": "string"
            },
            "example": "Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJleHAiOjI2NDk3NjU5MDEsImlhdCI6MTY0OTc2NTkwMSwiaXNzIjoiQ0hBSVBBWSIsInN1YiI6Ik5QU2taWlllZkd5S3ZCeGkifQ.VHicuV4dvfp8skktlcRVJNS_WwsD_MtKB4JLBbLWOcQ"
          },
          {
            "name": "merchantOrderRef",
            "in": "path",
            "schema": {
              "type": "string"
            },
            "required": true,
            "example": "MERCHANT1647433108462"
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response",
            "content": {
              "application/json": {
                "schema": {
                  "properties": {
                    "content": {
                      "$ref": "#/components/schemas/TransactionStatusContent"
                    },
                    "status_code": {
                      "description": "The status_code for API request execution result",
                      "type": "string"
                    },
                    "status_reason": {
                      "description": "The status_reason for API request execution result",
                      "type": "string"
                    }
                  }
                },
                "example": "{\n  \"content\": {\n      \"channel_order_ref\": \"6G457114F4645741R\",\n      \"order_ref\": \"2YGZp22ExeOu0As61wa7i0JyMJn\",\n      \"status\": \"Expired\"\n  },\n  \"status_code\": \"2000\",\n  \"status_reason\": \"SUCCESS\"\n}"
              }
            }
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "TransactionStatusContent": {
        "title": "TransactionStatusContent",
        "type": "object",
        "description": "The meta details of the transaction.",
        "properties": {
          "order_ref": {
            "type": "string",
            "description": "The unique Order reference generated by PortOne for transaction."
          },
          "channel_order_ref": {
            "type": "string",
            "description": "The unique Order reference generated by PSP for transaction."
          },
          "status": {
            "type": "string",
            "description": "The status of the transaction."
          }
        }
      }
    }
  },
  "x-readme": {
    "explorer-enabled": true,
    "proxy-enabled": true
  }
}
```