WooCommerce와 Shopify에 암호화폐 결제 연동하기
이미 WooCommerce나 Shopify에서 스토어를 운영하고 있다면, 암호화폐를 추가하는 일은 새로 만드는 작업이 아닙니다. 기존 결제 수단 옆에 새 결제 수단 하나가 놓이는 것이고, 연결하는 방법은 두 가지뿐입니다. 플러그인을 설치하고 API 키를 붙여 넣거나, 자체 코드에서 게이트웨이의 REST API를 호출합니다. 어느 쪽이 맞는지는 기술 역량보다 결제 과정을 얼마나 직접 관리하고 싶은지에 달려 있습니다.
먼저, 왜 하는지 정하세요
암호화폐가 카드를 대체하는 경우는 드뭅니다. 아래 중 하나라도 해당하면 추가할 가치가 있고, 하나도 해당하지 않으면 건너뛰어도 됩니다.
- 카드 결제가 불안정하거나 비싼 지역의 고객에게 판매합니다.
- 지불 거절 사기가 실제 비용이 되는 디지털 상품을 판매합니다. 온체인 결제는 되돌릴 수 없습니다.
- 고객이 이미 스테이블코인을 보유하고 있고 그것으로 결제하고 싶어 합니다.
- 단일 매입사와의 관계에 의존하지 않는 결제 수단을 원합니다.
이유를 분명히 하면 연동에 얼마나 공을 들여야 할지도 알 수 있습니다. "고객 몇 명이 요청한다"면 플러그인 방식이 맞습니다. "우리 시장의 3분의 1이 이렇게 결제한다"면 제대로 만들 가치가 있습니다.
방법 1: 플러그인 방식
기성 플랫폼에서 가장 빠른 길은 해당 플랫폼용 VisualPay 플러그인입니다. 설치하고, 가맹점 API 키를 붙여 넣고, 받을 코인과 네트워크를 고르면 결제 단계에 암호화폐가 선택지로 나타납니다. 코딩은 필요 없습니다.
표준 스토어를 운영하고, 테마의 결제 화면이 기본 상태에 가깝고, 이번 분기가 아니라 이번 주에 암호화폐 결제를 열고 싶다면 이 방식이 맞습니다.
설정 순서는 다음과 같습니다.
- VisualPay 계정을 만들고 2단계 인증을 켭니다. 가맹점을 만들려면 반드시 필요합니다.
- 가맹점을 만들고, 받으려는 코인과 네트워크마다 본인 지갑 주소를 등록합니다. 정산 대금이 이곳으로 갑니다.
- 패널의 가맹점 상세 페이지에서 가맹점 API 키를 복사합니다.
- 스토어에 플러그인을 설치하고 키를 붙여 넣습니다.
- 코인과 네트워크를 고르고, 결제 수수료를 누가 부담할지 설정합니다.
- 공지하기 전에 소액의 실제 주문을 처음부터 끝까지 진행해 봅니다.
방법 2: 직접 API 방식
헤드리스 스토어이거나, 결제 화면을 많이 커스터마이징했거나, 스토어의 일부만 플랫폼에 올라가 있다면 API를 직접 호출해 완전한 통제권을 가질 수 있습니다. 거래를 생성하는 POST 한 번과 결제 사실을 알려 주는 웹훅 하나면 됩니다.
POST https://visualpay.net/api/v1/merchant/transaction/create
x-api-key: YOUR_MERCHANT_API_KEY
Content-Type: application/json
{
"currency_symbol": "USDT",
"network_code": "trc20",
"amount_usd": 149.00,
"ttl": 30,
"order_id": 10432,
"email": "buyer@example.com",
"callback_url": "https://yourstore.com/checkout/crypto/return"
}
응답으로 결제 주소, 정확한 암호화폐 수량, 추적 코드를 받습니다. 리디렉션을 강제하는 것이 없으므로 자체 결제 단계 안에 그대로 표시할 수 있습니다. 같은 테마, 같은 도메인, 같은 언어로 보여 줄 수 있습니다. 추적 코드는 주문과 함께 저장하세요. 그때부터 이 값이 결제를 다루는 열쇠가 됩니다.
암호화폐 결제 단계를 나머지 결제 화면과 똑같이 보이게 하고 싶거나, 주문 흐름이 플랫폼의 결제 게이트웨이 추상화에 깔끔하게 맞지 않거나, 웹훅 엔드포인트를 관리하는 일에 이미 익숙하다면 이 방식이 맞습니다.
결제 상태를 주문 상태에 매핑하기
연동이 가장 자주 어긋나는 지점이므로 분명히 해 둘 필요가 있습니다. 암호화폐 거래에는 스토어가 기본적으로 이해하지 못하는 상태가 있으니, 무엇이든 작성하기 전에 매핑부터 정하세요.
- 대기: 청구서가 열려 있고 아직 결제되지 않았습니다. 주문을 보류 상태로 두세요. 한정된 재고를 무기한 잡아 두지 마세요. 유효 시간이 재고를 풀 시점을 알려 줍니다.
- 확인: 결제되어 온체인에서 정산되었습니다. 주문을 처리 중 또는 완료로 바꾸고 이행하세요. 이행을 일으켜야 하는 유일한 상태입니다.
- 초과 입금: 필요한 금액보다 많이 받은 상태로 승인되었습니다. 결제된 것으로 처리하고 초과분에 대한 정책(스토어 적립금 또는 수동 환불)을 적용하세요.
- 만료: 결제 없이 시간이 끝났습니다. 주문을 취소하고 재고를 푸세요. 청구된 것은 없습니다.
- 취소: 구매자가 의도적으로 그만두었습니다. 만료와 똑같이 처리합니다.
어느 방식을 택하든 API 가이드의 규칙은 그대로 적용됩니다. 구매자를 성공 페이지로 돌려보내는 콜백 리디렉션은 사용자 경험이지 결제 증거가 아닙니다. 웹훅이나 서버 측 상태 조회를 근거로 이행하세요. 브라우저가 URL을 불러왔다는 사실만으로 이행해서는 안 됩니다.
코인과 네트워크 선택하기
선택지가 많다고 좋은 것은 아닙니다. 드롭다운 항목이 열네 개인 결제 화면은 세 개인 화면보다 전환율이 낮고, 네트워크가 하나 늘 때마다 정확히 입력해야 할 지갑 주소도 하나씩 늘어납니다.
대부분의 스토어는 TRC20의 USDT(수수료가 낮고 보유자가 매우 많음), BEP20의 USDT(역시 저렴하고 거래소 이용자에게 흔함)로 시작하고, 선호하는 구매자가 있다면 ERC20의 USDC를 더하면 됩니다. 그 밖의 것은 고객이 실제로 요청할 때만 추가하세요. VisualPay에서는 코인과 네트워크를 가맹점 단위로 켤 수 있으므로 이 목록은 다시 만들 필요 없이 설정으로 바꿀 수 있고, 스토어를 여러 개 운영한다면 스토어마다 따로 둘 수 있습니다.
가격과 수수료
VisualPay는 성공한 거래마다 고정 비율 하나만 부과하며 월 비용과 정산 수수료가 없습니다. 결제 과정의 어느 쪽이 부담할지는 직접 정합니다. 수수료를 구매자에게 넘기면 청구 금액이 그만큼 올라가 주문 금액이 전액 입금되므로 장부가 깔끔해집니다. 가맹점이 부담하면 구매자는 예상한 딱 떨어지는 금액을 보게 되고, 일반 소비자 대상 스토어에서는 대체로 전환율이 더 좋습니다.
정산이 비수탁형이므로, 확인된 결제 대금은 네트워크별 기준 금액에 도달하면 등록한 지갑 주소로 바로 전송되며 보통 1분 안에 끝나고 체인 자체의 네트워크 수수료만 차감됩니다. 그 사이에 정산 일정도 출금 요청도 없습니다.
공지하기 전에 테스트하세요
이 단계를 건너뛰지 말고, 순조로운 경우만 테스트하지도 마세요.
- 소액의 실제 주문을 넣고 결제합니다. 누구도 관리자 화면을 건드리지 않아도 주문이 자동으로 결제 완료로 바뀌는지 확인하세요.
- 주문을 만들고 결제하지 않은 채 만료되게 둡니다. 주문이 취소되고 재고가 풀리는지 확인하세요.
- 일부러 조금 적게 결제합니다. 설정한 부족분 허용 오차대로 동작하는지 확인하세요.
- 확인 이메일과 고객이 보는 주문 페이지가 암호화폐 주문에서도 자연스러운지 점검하세요.
- 주문이 결제 완료로 표시되는 것만 보지 말고, 정산 대금이 본인 지갑에 실제로 들어왔는지 확인하세요.
어느 방식을 고를까요
스토어가 기본 상태에 가깝고 유지 관리 부담을 최소로 하면서 빨리 암호화폐 결제를 열고 싶다면 플러그인 방식을 택하세요. 결제 화면이 커스텀이거나, 헤드리스이거나, 결제 단계에서도 구매자를 자체 도메인에 머물게 하는 것이 중요하다면 API 방식을 택하세요.
두 방식 모두 같은 게이트웨이에 연결되고 같은 지갑으로 정산됩니다. 플러그인은 통제권을 조금 내주고 속도를 크게 얻습니다. API는 하루치 작업을 들여 경험 전체를 통제합니다. 어느 쪽을 택해도 나중에 다른 쪽으로 바꿀 수 있습니다.
오늘부터 USDT와 USDC 결제를 받아 보세요
KYC 없이 시작하고, 결제 화면은 내 사이트에 두고, 대금은 내 지갑으로 정산받으세요. 가입과 첫 가맹점 등록은 무료입니다.