In-app payment

Check payment status

post

You can look up the transaction status and transaction details of the created payment. Depending on the situation, you can also use it when you did not receive an approval response.

Business error code

The errors below respond with HTTP 200 and resultType: FAIL.

errorCode	Description
4095	You have exceeded the request limit. Please try again later.

Request limit: 3,000 times per minute per app

Authorizations

mutualTLS

This is client-certificate-based mTLS authentication issued to the partner. The mini app is identified by the certificate's CN. Refer to the Use the server API document for how to issue and manage certificates.

Body

This is the request body for in-app purchase order status lookup.

orderIdstringRequired

This is the ID of the in-app purchase order to look up.

Example: a1b2c3d4-e5f6-4789-a0b1-c2d3e4f5a6b7

Responses

200

Successfully retrieved in-app payment status

application/json

or

400

The request body is not in the correct format. Check the field-by-field details in error.data.errorDetails.

application/json

500

This is an unclassified server error. If it keeps failing, please contact the partner support channel.

application/json

post/api-partner/v1/apps-in-toss/order/get-order-status

POST /api-partner/v1/apps-in-toss/order/get-order-status HTTP/1.1
Host: apps-in-toss-api.toss.im
Content-Type: application/json

{
  "orderId": "a1b2c3d4-e5f6-4789-a0b1-c2d3e4f5a6b7"
}

{
  "resultType": "SUCCESS",
  "success": {
    "orderId": "a1b2c3d4-e5f6-4789-a0b1-c2d3e4f5a6b7",
    "reason": "구매가 완료됐어요.",
    "sku": "monthly_subscription",
    "status": "PURCHASED",
    "statusDeterminedAt": "2025-04-22T15:30:00"
  }
}