지갑 결제와 함께 카드 결제를 제공하고, 인보이스 지갑으로 Base의 USDC를 받아요.
1. Coinflow 계정 확인
Wholly Crypto 9.0.0 이상을 사용하세요. Coinflow에 사업 승인을 받고 인보이스별 수신 주소로 Base USDC를 정산하도록 요청하세요. 운영 환경에서는 고객이 제공업체 수수료를 부담해야 하며 정산금 유보나 공제가 없어야 해요.
이용 가능 여부, 신원 확인, 한도, 수수료는 Coinflow 계정과 고객 위치에 따라 달라요. 결제 전에 Coinflow에서 최종 금액을 확인하세요.
2. 연결하고 샌드박스에서 테스트
Settings → Fiat payments를 여세요. Coinflow merchant ID, API key, Webhook Validation Key를 저장하세요. 표시된 콜백 URL을 Coinflow에 추가하고 연결을 확인하세요. 인증 정보는 서버에 보관하고 지갑 키는 절대 공유하지 마세요.
관리자 샌드박스 결제는 샌드박스 수신 주소를 사용하는 별도의 10 USD 테스트예요. 실제 인보이스를 결제하지 않아요. 연결 확인에 성공했다고 사업이나 결제 자격까지 확인된 것은 아니에요.
3. 스토어에서 Base USDC 켜기
프로젝트 지갑을 백업하고 Base 스캐너를 확인하세요. Store → Payment methods에서 Base의 네이티브 USDC를 허용하고 카드 결제를 켜세요. USDbC나 Ethereum의 USDC가 아닌 USDC를 사용하세요. Base USDC를 제외한 인보이스에는 카드 옵션이 나오지 않아요.
4. 소액 실제 결제 테스트
Coinflow 승인 후 운영 환경을 켜고 수동이나 API로 일반 인보이스를 만드세요. 결제 화면에서 카드를 선택하세요. 인보이스의 원래 통화, 견적, 스프레드는 유지되며 Coinflow가 결제 전에 최종 수수료와 환전 내역을 고객에게 보여 줘요.
5. 주문 처리 전에 입금 확인
USDC가 도착하고 설정한 블록체인 확인 정책을 충족해야 인보이스가 정산돼요. 카드 승인이나 결제 화면으로 돌아오는 것만으로는 지급 증명이 되지 않아요.
인보이스의 Card payment 상세와 Base의 USDC 거래를 확인하세요. 기존 서명된 IPN 또는 웹훅 주문 처리 흐름을 유지하세요. invoice.settled를 기준으로 처리하고 requires_review를 확인하세요. 브라우저 복귀만으로 처리하면 안 돼요. 늦거나 정보가 엇갈리는 결제는 검토가 필요할 수 있어요.
6. 자금 스윕과 예외 처리
받은 USDC를 콜드 지갑으로 보내려면 Base에 ETH를 남겨 두거나 자동 가스 충전과 스윕을 설정하세요. 카드 환불과 차지백은 Coinflow에서 처리하세요. 제공업체 거래의 발신 주소로 암호화폐를 환불하면 안 돼요. 분쟁은 Needs attention에서 확인하세요.