Payment generator

VeilPay는 두 가지 결제 방법을 지원합니다:

직접 방식은 결제를 받기 시작하는 가장 쉬운 방법입니다. 결제 링크를 생성해 사용자에게 보내면, 사용자가 링크를 열어 거래를 완료합니다. 이 방법은 백엔드 연동이 필요 없습니다. 다만 거래 매개변수(금액, 주소 등)를 사용자가 수정할 수 있으므로, 재화나 서비스를 제공하기 전에 결제가 올바른 주소로 수령되었는지 항상 확인해야 합니다.

간접 방식은 거래에 대한 더 많은 제어권을 제공합니다. 이 흐름에서는 먼저 거래를 생성하여 거래 ID를 받습니다. 이후 사용자에게 결제 세부 정보를 제시합니다. 거래가 사전에 생성되므로 사용자가 결제 매개변수를 변경할 수 없습니다. 또한 거래 ID로 거래 상태를 추적할 수 있습니다. 이 방법으로 생성된 거래는 72시간 이내에 시작되어야 하며, 그렇지 않으면 데이터베이스에서 자동으로 삭제됩니다.

다음을 원하신다면 사전 생성 거래 방식을 사용하세요:

결제 흐름에 대한 더 많은 제어

거래 상태 추적 기능

매개변수 변경에 대한 더 강력한 보호

다음을 원하신다면 직접 링크 방식을 사용하세요:

가장 빠른 연동

백엔드 개발 불필요

간단한 결제 링크 흐름

VeilPay 거래는 현재 거래당 5 BTC 상당으로 제한됩니다.

이 한도는 처리 지연을 최소화하고 KYC 관련 위험을 줄이는 데 도움이 됩니다.

사용자가 수령하기로 선택한 것과 동일한 암호화폐를 보내면 교환이 필요하지 않습니다.

Veil은 이러한 거래에 어떠한 수수료도 청구하지 않습니다.

거래 생성 시 이메일 알림이 활성화되어 있으면 결제가 완료될 때 알림을 받게 됩니다.

VeilPay는 법정화폐 결제를 직접 처리하지 않습니다.

다만 거래 가격을 법정화폐(USD, EUR 등)로 정의할 수 있습니다.

VeilPay는 현재 환율을 사용해 금액을 자동으로 상응하는 암호화폐 가치로 변환합니다.

사전 생성(간접) 방식은 서버 간 연동을 위해 만들어졌습니다. 백엔드에서 저희 REST API를 통해 결제를 생성하면 anonpay_id를 받게 되며, 해당 id로 VeilPay 위젯을 표시하거나 임베드할 수 있습니다. 모든 결제 매개변수는 저희 쪽에 저장되므로 고객이 금액, 주소 또는 다른 필드를 변경할 수 없습니다.

모든 엔드포인트는 VeilPay 도메인의 /api/anonpay 하위에 있습니다. 공개되어 있으며 결제 생성에 API 키나 서명이 필요하지 않습니다.

서버에서 받고자 하는 코인과 네트워크, 지갑 주소, 금액을 담아 /api/anonpay/prepare로 POST 요청을 보내세요. 이 시점에는 주문이 생성되지 않으며, 결제 의도만 예약됩니다.

고객을 해당 id의 결제 페이지로 리다이렉트하거나, 본인의 페이지에 iframe으로 임베드하세요. 위젯은 금액과 주소가 고정된 상태로 열리며, 고객은 결제할 코인만 선택합니다.

GET 요청으로 언제든 현재 상태를 확인할 수 있습니다. 상태는 prepared → waiting_deposit → deposit_received → exchanging → sending → completed 순으로 진행됩니다.

폴링 대신, 결제 생성 시 웹훅 URL을 전달하면 상태가 변경될 때마다 POST 요청을 받을 수 있습니다: