应用内支付

查询支付状态

post

可以查询已创建支付单的交易状态和交易事务。视情况而定，即使未收到授权响应时也可使用。

业务错误码

以下错误将以 HTTP 200 和 resultType: FAIL 响应。

errorCode	说明
4095	请求已超过限制。请稍后重试。

请求限额: 每个应用每分钟 3,000 次

授权

mutualTLS

这是基于为合作伙伴签发的客户端证书的 mTLS 认证。通过证书的 CN 来识别迷你应用。证书签发·管理方法请参考 使用服务器 API 文档。

请求体

这是查询应用内支付订单状态的请求正文。

orderIdstring必填

这是要查询的应用内支付订单 ID。

Example: a1b2c3d4-e5f6-4789-a0b1-c2d3e4f5a6b7

响应

200

应用内支付状态查询成功

application/json

或

400

请求正文不符合格式。请在error.data.errorDetails中查看各字段详情。

application/json

500

未分类的服务器错误。如果持续失败，请联系合作伙伴支持渠道。

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"
  }
}