엔드투엔드 플로우

"장바구니 추가"에서 월렛의 USDC까지.

Polygonscan을 확인할 필요 없습니다. 모든 결제가 웹훅 + 이메일 + 선택적 Telegram DM을 트리거합니다.

전체 플로우

10단계. 놀라움 제로.

Customer, Merchant Site, The Desk와 카드 온램프 사이의 클릭부터 USDC 정산까지 10개 메시지를 보여주는 The Desk 결제 시퀀스 다이어그램
  1. 고객이 여러분의 사이트에서 장바구니에 추가

    BPC-157 + Retatrutide가 장바구니에.

  2. WooCommerce가 주문 #1234 생성

    상태: 결제 대기. 재고 확보됨.

  3. 보안 체크아웃으로 리다이렉트

    pay.qistdigital.com/session/xyz에서 체크아웃을 호스팅합니다. order_id가 메타데이터로 전달됩니다.

  4. 고객이 방법 선택

    Apple Pay / Google Pay / 카드 / 암호화폐 직접. 금액 기반 스마트 추천.

  5. 결제 레일이 인계받음

    카드 온램프가 카드를 처리합니다. 또는 암호화폐 직접을 받습니다. 자금이 The Desk 잔액에 절대 닿지 않습니다.

  6. USDC가 여러분의 월렛에 도착

    Polygon. ~30초. PolygonScan에서 검증 가능 (굳이 하지 않아도 됨).

  7. 정산 레이어가 저희에게 핑 (IPN)

    백엔드 확인: 결제가 최종입니다.

  8. 저희가 여러분 사이트에 핑 (HMAC 웹훅)

    /wc-api/peptidepay_webhook_authed로 서명된 POST. 플러그인이 시그니처를 검증하고, 주문 #1234를 찾고, payment_complete()을 호출합니다.

  9. 여러분 사이트 + WooCommerce가 주문 업데이트

    상태가 'Processing'으로 전환됩니다. 이메일 발송: 여러분에게 ('새 결제 주문'), 고객에게 ('주문 확인').

  10. 여러분이 배송

    WC 관리자 확인. 주문 #1234 매칭. 배송. 완료.

세 가지 설정

스택을 선택하세요.

동일한 플로우, 세 가지 연결 방법.

A

WooCommerce 플러그인

  • 플러그인 설치 → 월렛 붙여넣기 → 완료.
  • 웹훅 + 이메일 + WC 이메일 체인, 모두 자동.
플러그인 다운로드
B

커스텀 웹사이트

(Next.js, 정적, 아무거나)

  • /api/v1/checkout/init 호출 → 고객 리다이렉트 → /your-webhook 리슨.
  • 저희가 HMAC-SHA256으로 서명합니다. 여러분이 검증. 여러분의 DB + 이메일 업데이트.
API 문서
C

웹사이트 없음

(Telegram / IG / DM)

  • 저희 봇에서 /pay 80 EUR 사용. 고객에게 링크 전송.
  • 그들이 결제. 여러분은 월렛에 $ 수령 + DM 확인.
Telegram 설정
알림

"그런데 결제받은 걸 어떻게 아나요?"

  • WooCommerce 이메일 관리자에게 (플러그인 모드 시)
  • 저희 이메일 알림 주소로 ("새 결제: $150")
  • Telegram DM 저희 봇 통해 (opt-in)
  • 라이브 대시보드 pay.qistdigital.com/app에서 (상단 지표 10초마다 업데이트)
  • 여러분 사이트로의 웹훅 서버가 다운된 경우 ~42시간에 걸쳐 6회 재시도
  • PolygonScan 편집증이 있는 사람을 위해 — 모든 tx가 온체인 검증 가능

결제 확인 몇 초 이내에 알게 됩니다.

FAQ

엣지 케이스.

여러분이 웹훅을 보낼 때 제 사이트가 다운이면요?
~42시간에 걸쳐 6회 재시도합니다 (5분 → 15분 → 1시간 → 4시간 → 12시간 → 24시간). 그 후 전달이 데드레터됩니다. GET /api/v1/sessions/{id}로 폴링하여 언제든지 재동기화할 수 있습니다.
실제 돈 없이 테스트할 수 있나요?
샌드박스 네트워크는 없습니다 — 모든 결제는 실제 온체인 정산입니다. 가장 위험이 적은 테스트는 본인에게 환불하는 $1 실제 결제입니다. 웹훅만 무료로 테스트하려면 sk_test_ 키로 /api/v1/test/fire-webhook에 서명된 이벤트를 발사하세요.
제 order_id를 추가할 수 있나요?
네, /api/v1/checkout/initmetadata: {order_id: "1234"}를 전달하세요. 웹훅 페이로드에서 그대로 반환합니다.
어떤 데이터를 저장하나요?
session_id, wallet, amount, status, 고객 이메일(로그용 해싱). 모든 내용은 /privacy에 있습니다.
차지백?
불가능. 온체인 USDC는 최종입니다. 그게 핵심입니다.

플러그인 준비되셨나요?

여러분의 스택에 맞는 경로를 선택하세요. 세 가지 모두 동일한 결제 레일을 공유합니다.