sayren Docs
주문

현금영수증 재발급

발급이 실패했거나(`FAILED`) 재시도를 기다리는(`PENDING`) 현금영수증을 지금 다시 발급·취소한다. 스코프 `order:rw`, 상점 플랫폼에 로그인한 OWNER·ADMIN만 호출할 수 있다. - 발급해야 할 금액은 결제 금액에서 환불 완료 금액을 뺀 값이다. 부분 환불이 있었으면 그 금액으로 발급하거나 취소한다. - 식별 번호 오류처럼 결제사가 거절한 발급은 새 발급 건으로 다시 요청한다. 같은 번호면 다시 거절될 수 있다. - 응답은 처리 뒤의 현금영수증이다. 결제사 응답이 늦으면 `PENDING`으로 남고 자동으로 다시 시도한다.

POST
/v1/orders/{orderId}/cash-receipt/reissue

발급이 실패했거나(FAILED) 재시도를 기다리는(PENDING) 현금영수증을 지금 다시 발급·취소한다. 스코프 order:rw, 상점 플랫폼에 로그인한 OWNER·ADMIN만 호출할 수 있다.

  • 발급해야 할 금액은 결제 금액에서 환불 완료 금액을 뺀 값이다. 부분 환불이 있었으면 그 금액으로 발급하거나 취소한다.
  • 식별 번호 오류처럼 결제사가 거절한 발급은 새 발급 건으로 다시 요청한다. 같은 번호면 다시 거절될 수 있다.
  • 응답은 처리 뒤의 현금영수증이다. 결제사 응답이 늦으면 PENDING으로 남고 자동으로 다시 시도한다.

Authorization

accessToken
AuthorizationBearer <token>

Sayren 계정 토큰(로그인 토큰 또는 개인 액세스 토큰, RFC 9068 JWT)

In: header

Path Parameters

orderId*string

Header Parameters

X-Store-Id*string

대상 상점 id. 토큰의 상점 범위 밖이면 403 STORE_NOT_GRANTED, 없으면 400 STORE_ID_REQUIRED다

Response Body

application/json

curl -X POST "https://example.com/v1/orders/string/cash-receipt/reissue" \  -H "X-Store-Id: string"
{  "meta": {    "status": 200,    "code": "OK",    "message": "OK",    "isSuccess": true  },  "data": {    "cashReceiptId": "string",    "status": "string",    "type": "string",    "identityType": "string",    "identityNumberMasked": "string",    "amount": 0,    "issuedAmount": 0,    "provider": "tosspayments",    "issueNumber": "string",    "receiptUrl": "string",    "issuedAt": "string",    "canceledAt": "string",    "failCode": "string",    "failMessage": "string",    "reissuable": true,    "requestedAt": "string",    "updatedAt": "string"  },  "error": null}

주문 전체 행동 실행 POST

같은 행동을 그 행동이 켜진 주문상품마다 실행하고 결과를 주문상품별로 준다(부분 실행 — 한 주문상품의 실패가 다른 주문상품을 되돌리지 않는다). 그 행동이 없는 주문상품은 SKIPPED다. 켜진 주문상품이 하나도 없으면 409 `ACTION_NOT_AVAILABLE`. `Idempotency-Key`로 재시도가 안전하다.

결제 내역 조회 GET

PG에 오간 결제를 건 단위로 조회한다. 스코프 `settlement:r`. - 주문 목록과 다르다. **주문이 만들어지지 않은 결제도 나온다**(카드 거절, 결제창 이탈, 승인 결과 확인 중). - 한 결제 건에 시도가 여럿일 수 있다(거절 뒤 다른 PG로 재시도). 응답의 `provider`·`method`·`pgTransactionId`는 승인한 시도의 값이고, 승인이 없으면 마지막 시도의 값이다. - `status`는 환불까지 반영한다. 부분 환불은 `PARTIALLY_REFUNDED`, 전액 환불은 `REFUNDED`다. - `method`는 **실제 결제수단**이다. PG가 보고한 수단을 쓰고, 모르면 주문서에서 요청한 수단으로 대신한다. - 테스트 결제는 기본으로 빠진다. `includeTest=true`면 포함한다. - 기간 기준은 결제 시작 시각이고 최대 92일이다. 생략하면 최근 30일이다.