개발하기

참고하세요

SDK 0.0.33 버전 이상 사용해주세요.

1. 상품 목록 가져오기

SDK를 통해 연동해 주세요.

콘솔에서 등록한 인앱결제 상품 목록을 가져옵니다.
상품 목록을 화면에 표시할 때 사용해요.
IapProductListItem 페이지를 확인해주세요.

참고하세요

인앱결제를 샌드박스 앱에서 테스트할 때는 실제 등록/승인된 상품이 아니라,

테스트 상품 - 1, 테스트 상품 - 2 같은 mock 데이터가 노출돼요.

토스앱 내에서 동작할 때는 승인된 실제 상품 목록이 정상적으로 보여져요.

2. 인앱결제 요청하기

SDK를 통해 연동해 주세요.

인앱결제 결제창을 띄우고, 사용자가 결제를 진행해요.
결제 후 앱인토스 내부에서 실제 결제가 되었는지 검증을 진행합니다. 결제가 성공하면 결제 결과를 내려드려요.
앱인토스는 결제 완료 후 구글/애플 영수증까지 확인하여 결제가 되었는지 검증해요.
만약 결제 중에 에러가 발생하면 에러 유형에 따라 에러 페이지로 이동해요.

createOneTimePurchaseOrder 페이지를 확인해주세요.

주의하세요

현재 환불에 대한 최종 권한은 앱마켓에 있어요.

✅ 앱마켓을 통한 환불 요청 및 승인 여부를 확실히 알 수 없기 때문에, 소액으로만 테스트해 주세요.

3. 결제 상태 조회하기

인앱결제 주문건의 거래 상태를 조회해요.
상황에 따라, 승인 혹은 환불 응답을 수신하지 못한 경우에도 활용 가능해요.

• Content-type : application/json
• Method : POST
• URL : /api-partner/v1/apps-in-toss/order/get-order-status

참고하세요

앱인토스는 결제 완료 후 구글/애플 영수증까지 확인하여, 결제가 성공되면 승인 결과를 내려드려요

요청 헤더

이름	타입	필수값 여부	설명
x-toss-user-key	string	Y	토스 로그인을 통해 획득한 userKey 값

요청 파라미터

이름	타입	필수	설명
orderId	String	Y	결제 생성 후 취득한 주문번호(uuid v7)

{
    "orderId": "13c9a1ff-2baa-4495-bbfa-a0826ba8c7c0"
}

응답

이름	타입	설명
orderId	String	요청한 주문번호
status	String	주문에 대한 상태 (enum)
reason	String	상태에 대한 설명

status (enum)

상태	설명
PURCHASED	구매 완료
ORDER_IN_PROGRESS	주문이 진행 중
FAILED	주문이 실패함
REFUNDED	주문이 환불됨
NOT_FOUND	주문을 찾을 수 없음
MINIAPP_MISMATCH	주문한 상품이 해당 앱에서 판매하는 상품이 아님
ERROR	내부 상태 이상

{
    "resultType": "SUCCESS",
    "success": {
        "orderId": "13c9a1ff-2baa-4495-bbfa-a0826ba8c7c0",
        "status": "ORDER_IN_PROGRESS",
        "reason": "진행 중인 주문입니다."
    }
}