메인 콘텐츠로 건너뛰기
Pending 주문에 대한 결제 세션을 생성하거나 새로고침합니다. 결제 작업은 결제 채널에 접근하며 주문 상태를 변경할 수 있으므로, 호출 전에 반드시 주문 ID, 금액 및 결제 방식을 확인해야 합니다.

인터페이스 개요

익명 결제의 경계

익명 접근은 복사된 결제 링크를 연 후 로그인 상태가 사라진 상황에 사용되며, 장기 Account Token을 전달할 필요도 없고 전달해서도 안 됩니다. 익명 호출:
  • 서버 측에서 구성된 호스팅 리디렉션 결제 방식만 허용합니다;
  • 데스크톱 결제 페이지를 고정으로 사용합니다;
  • 무료 주문을 수령할 수 없습니다;
  • IP 및 단일 주문 제한이 적용됩니다;
  • 계정, Application 또는 내부 metadata를 포함하지 않는 최소 주문 프로젝션을 반환합니다.
인증된 호출자는 반드시 주문 소유자 또는 슈퍼 관리자여야 합니다. X402, 보상 교환 등 사용자 컨텍스트가 필요한 방식은 익명으로 호출할 수 없습니다.

요청 예시

인증이 필요한 결제 방식:
pay_way에는 주문 모델이 지원하는 실제 값을 사용합니다. 예: WechatPay, AliPay, Stripe, Card, Airwallex, X402, PayPal, AppleIAP, Reward, BankTransfer. 모든 값이 익명 요청 또는 모든 사이트에서 열려 있는 것은 아닙니다.

응답 설명

성공 응답은 업데이트된 주문 객체이며, 일반적으로 pay_url을 통해 다음 단계 진입점을 제공합니다; 결제 방식에 따라 제어된 필드에서 클라이언트가 결제를 계속하는 데 필요한 정보를 반환할 수도 있습니다. 익명 응답은 최소 필드 화이트리스트를 사용하며, 인증된 소유자는 전체 세부 정보를 받습니다. payment_url, qr_code_url 또는 payment_method 등의 이전 필드명에 의존하지 마세요; 현재 Order 계약은 pay_url 및 pay_way를 사용합니다.

은행 송금

로그인한 개인 계정과 기업 계정 모두 BankTransfer를 사용할 수 있으며, 기업 인증이 필요하지 않습니다. 중국 내 위안화 송금과 국제 미국 달러 송금 모두 주문 금액이 최소 300달러 이상이어야 합니다; 위안화 지급 금액은 결제 시 표시되는 금액을 기준으로 합니다. 결제 전에 GET /api/v1/orders/{order_id}/payment-options/를 통해 현재 주문에 사용 가능한 송금 경로 및 금액 기준을 조회할 수 있습니다. 은행 송금은 주문 소유자가 로그인한 후 시작해야 하며, 수금 채널 구성 및 플랜 적용 범위의 제한을 받습니다; 익명 요청은 사용할 수 없습니다.

iOS 인앱 구매

로그인한 주문 소유자는 pay_way: "AppleIAP"를 전달할 수 있습니다. 이 요청은 선택한 플랜의 metadata.apple_price에 따라 미결제 주문을 업데이트하고 할인을 제거하며, 청구를 발생시키지 않고, 크레딧을 지급하지 않으며, 결제 링크도 반환하지 않습니다. 기존 미결제 주문은 먼저 이 단계를 완료한 후 Apple 네이티브 결제를 시작해야 합니다. 구성된 Apple 상품 및 가격이 하나인 Usage 플랜만 지원합니다; 지원되지 않는 플랜 또는 일괄 주문은 400을 반환합니다. Apple 네이티브 결제 후 /api/v1/orders/{id}/apple-verify/를 통해 transaction_id를 제출하여 서버 측 검증 및 크레딧 지급을 완료합니다. 크레딧 수량은 플랜에서 가져옵니다; 금액은 Apple의 독립적인 미국 달러 사전 설정 가격을 사용하며, 회원 할인이나 사이트 추가 요금이 중첩되지 않고, 기타 지역의 현지 통화 청구 금액은 Apple 확인 페이지를 기준으로 합니다.

오류 및 재시도

  • 주문이 Pending이 아님: 400을 반환합니다; 결제 세션을 반복 생성하지 마세요.
  • pay_way를 제공하지 않음: 0이 아닌 금액의 주문은 400을 반환합니다.
  • 익명 호출에서 허용되지 않는 방식 또는 무료 주문을 사용함: 403을 반환하며, 로그인 후 소유자가 재시도합니다.
  • 인증되었지만 주문 소유자가 아님: 403을 반환합니다.
  • 결제 채널 실패: 무작정 반복 제출하지 마세요; 먼저 주문 세부 정보를 조회하고 여전히 Pending인지 확인한 후 재시도하세요.

관련 인터페이스