결제 수단 가이드
CROSS PAY 가 지원하는 결제 수단 및 지역별 가용성.
지원 결제 수단
CROSS Pay 는 다음 카테고리의 결제 수단을 제공합니다. 국가/통화별 가용성은 지원국가와 결제통화 에서 확인하세요.
| 카테고리 | type | 대표 결제 수단 | 지역 |
|---|---|---|---|
| 신용/체크카드 | CARD | Credit Card (payletter), Card (Worldpay) | US, JP, TW |
| 모바일 간편결제 | WALLET | LINE Pay, JKO Pay, PayPay, GCash, K Plus 등 | TH, JP, TW, PH, ID |
| 즉시이체 | BANK_TRANSFER | PromptPay, Bank Transfer | TH, ID |
| 편의점/통신사 바우처 | VOUCHER | 7-Eleven, Indomaret, Alfamart, Chunghwa Tel 등 | TW, ID, PH, TH |
| 암호화폐 | CRYPTO | Binance Pay, CROSS Pay (USDT / USDC / CROSSD) | Global |
카드 결제
Visa, Mastercard, JCB, Amex 를 지원합니다.
테스트 카드
| 카드 번호 | 결과 |
|---|---|
4242 4242 4242 4242 | 성공 |
4000 0000 0000 0002 | 거절 (card_declined) |
4000 0027 6000 3184 | 3DS 인증 필요 |
- 유효기간:
12/26(임의 미래 월) - CVC: 임의 3자리
간편결제 (PromptPay, GCash 등)
유저가 결제 화면에서 해당 앱으로 리 디렉트되거나 QR 을 스캔합니다.
PromptPay 흐름
결제 버튼 클릭
→ QR 코드 표시
→ 유저 모바일 뱅킹 앱으로 스캔
→ 결제 승인
→ onSuccess 콜백
Sandbox 환경에서는 실제 앱 연동 없이 결제 성공/실패를 시뮬레이션합니다.
암호화폐 결제
암호화폐 결제는 두 개의 글로벌 결제 수단(rail)으로 제공됩니다. 두 rail 모두
country=GL (Global) 매핑이며 tax_manager=SERVICE 로 동작합니다.
| 결제 수단 | provider | pg_fee_rate | 청구 통화 (Production) |
|---|---|---|---|
| Binance Pay | binancepay | 1.00 % | USDT (default) |
| CROSS Pay | crosspay | 0.00 % | USDT, CROSSD |
USDC 와 Tron USDT 는 런칭 후 단계에서 추가될 예정입니다.
Fiat 결제의 pegged stablecoin (include_pegged_assets)
법정통화로 결제를 생성하면, hosted checkout 이 해당 통화에 peg 된
stablecoin(USD → USDT / USDC / CROSSD)을 crypto 결제 옵션으로 함께 제공할
수 있습니다. 노출 여부는 POST /v1/payments 의 optional
include_pegged_assets 플래그가 결정합니다. 결정된 값은 생성 시 저장되며
모든 Payment 응답에 echo 됩니다.
include_pegged_assets 는 v0.7.51 에 opt-in(생략 = false,
stablecoin 숨김)으로 도입됐습니다. v0.7.55 부터 opt-out(생략 = true,
stablecoin 노출)입니다. 플래그 생략으로 stablecoin 을 숨기는 데 의존하던
연동은 이제 명시적으로 include_pegged_assets: false 를 보내야 합니다.
플래그에 따라 체크아웃 견적
(GET /v1/checkout/{checkout_id}/quotes)이 달라지는 방식:
| 생성 요청 | 견적에 포함되는 crypto 옵션 |
|---|---|
currency: "USD" — 플래그 생략 또는 true | USD 에 peg 된 stablecoin(USDT / USDC / CROSSD)이 fiat 결제수단과 함께 노출 (1 USD ≈ 1 USDT 페깅) |
currency: "USD", include_pegged_assets: false | 없음 — 체크아웃은 fiat 전용으로 유지 |
currency: "USDT" — 플래그 무효 | 정확히 USDT 만 (심볼 직접 매칭). 다른 pegged 자산(USDC / CROSSD)은 추가되지 않음 |
Given 플래그 없이 생성한 결제:
POST /v1/payments
{ "currency": "USD", "amount": "9.99", "payer_uid": "user-123" }
When buyer 가 체크아웃을 열면, then 견적에는 buyer 국가의 fiat
결제수단과 함께 crosspay-usdt, crosspay-crossd 같은 crypto 옵션이
1 USD ≈ 1 USDT 페깅으로 포함됩니다.
Given 동일 결제에 "include_pegged_assets": false 를 지정하면,
then 견적에는 fiat 결제수단만 포함되고 stablecoin 옵션은 제공되지
않습니다.
암호화폐 결제의 국가별 제한
Crypto 결제수단이 모든 국가에서 제공되는 것은 아닙니다. admin 이 관리하는 제한 리스트가 두 개의 독립적인 게이트를 통제합니다:
CRYPTO— buyer 의 IP 기반 국가(CloudFront-Viewer-Country — 클라이언트가 위변조할 수 없는 권위 신호)가 리스트에 있으면 hosted checkout 에서 모든 crypto 결제수단이 숨겨집니다. 제한국에서 crypto 견적을 선택하는 것도 서버 측에서 거부됩니다.ONRAMP— fiat→crypto 온램프(AlchemyPay) 주문이 요청 본문의country파라미터 기준으로 차단됩니다. 대한민국(KR)은 기본 제한입니다 (종전 온램프 country blacklist 에서 이관).
GET /v1/catalog 에도 동일한 CRYPTO 게이트가 적용됩니다: 제한국의
crypto 재화가 제외되어, 해당 지역의 체크아웃이 실제 제공하는 것과
카탈로그가 일치합니다. 응답 필드 구조는 불변 — 반환 집합만 좁아집니다.
지원 토큰 / 체인
같은 토큰 심볼이라도 체인별 decimals 와 contract 가 다르므로
amount_smallest_unit 변환 시 반드시 토큰 메타데이터를 참조하세요.
전체 contract address 와 ABI 는 GET /v1/chains/{slug} 로 조회하세요
(public, no auth). 본 페이지는 reference 용 스냅샷이며, 런타임에서는
반드시 API 응답값을 신뢰하세요.
| 결제 수단 | 토큰 | 체인 (slug) | chain_id | decimals | Token contract |
|---|---|---|---|---|---|
| Binance Pay | USDT | ethereum | 1 | 6 | 0xdAC17F958D2ee523a2206206994597C13D831ec7 |
| Binance Pay | USDT | bsc | 56 | 18 | 0x55d398326f99059fF775485246999027B3197955 |
| CROSS Pay | USDT | ethereum | 1 | 6 | 0xdAC17F958D2ee523a2206206994597C13D831ec7 |
| CROSS Pay | USDT | bsc | 56 | 18 | 0x55d398326f99059fF775485246999027B3197955 |
| CROSS Pay | USDT | cross | 612055 | 18 | 0x1c37d4F44ed3eC86d96868001CfA89e97112a85C (브리지 USDT) |
| CROSS Pay | CROSSD | cross | 612055 | 18 | 0xff42C13D927a6b9265236619161Accb227b6d452 |
전체 53국 매핑은 지원국가와 결제수단 카탈로그 참조. 공개 Sandbox 카탈로그는 곧 지원 예정입니다.
결제 흐름
결제 버튼 클릭
→ 체인 / 토큰 선택
→ 입금 주소 + 금액 표시
→ 유저 지갑에서 전송
→ 블록 컨펌 대기 (1~2분)
→ payment.succeeded Webhook
온체인 결제 환율
USD 로 생성된 세션을 CROSS Pay 로 처리할 경우, 결제 시점의 시세로 토큰
수량이 자동 계산됩니다 (1 USDT ≈ 1 USD 페깅 기준).
{
"currency": "USD",
"amount": 9900
}
// → USDT 9.9 (선택한 체인의 USDT 로 결제, 1 USDT = 1 USD 페깅)
USDT / USDC / CROSSD 같은 stablecoin 심볼을 통화로 직접 지정해 호출할
수도 있습니다 — 이 경우 환산 없이 해당 토큰 수량 그대로 청구됩니다.
온체인 결제 추가 필드
결제 완료 응답에는 체인 기준의 상세 정보가 payment_method_detail
필드로 포함됩니다.
{
"payment_method_detail": {
"chain": "ethereum",
"token": "USDT",
"to_address": "0x7a2…F3e",
"amount_token": "9.9",
"tx_hash": "0xabc…123",
"block_number": 12345678,
"confirmed_at": "2025-06-01T09:12:34Z"
}
}
결제 수단 활성화
머천트별 결제 수단 활성화는 현재 셀프-서비스 UI 가 제공되지 않으므로 다음 절차로 진행됩니다.
- support@crosspay.ai 또는 파트너 채널로 활성화 요청 (국가·통화·결제수단 명시)
- PG 계약 / 심사 완료 시 운영팀이 머천트에 결제수단 활성화
- sandbox 에서
GET /v1/checkout/{checkout_id}/quotes응답에 노출되는지 확인 후 운영 적용
활성화 상태는 GET /v1/checkout/{checkout_id}/quotes 응답으로만 확인할 수 있습니다.