판매자용 Bitfinex Pay를 사용하는 방법은 무엇입니까? (결제통합)

Bitfinex 페이 개요

1. Bitfinex Pay는 Bitfinex와 Tether를 운영하는 법인인 iFinex Inc.가 개발한 가맹점 대상 결제 처리 솔루션입니다.

2. 기업은 고객에게 거래소 계좌를 보유할 필요 없이 웹사이트나 POS 시스템에서 직접 암호화폐 결제를 수락할 수 있습니다.

3. 이 서비스는 BTC, ETH, USDT, UNUS SED LEO를 포함한 주요 암호화폐를 지원하며 법정화폐로의 실시간 변환 옵션을 제공합니다.

4. 통합은 주문 상태 업데이트 및 정산 조정을 위해 RESTful API 및 웹훅 기반 알림 아키텍처를 사용합니다.

5. 판매자는 프로덕션 자격 증명에 액세스하기 전에 Bitfinex의 기관 온보딩 포털을 통해 KYC 확인을 완료해야 합니다.

기술 통합 단계

1. 개발자는 Bitfinex Pay 개발자 포털에 액세스하여 가맹점 애플리케이션을 등록하고 결제 시작 및 웹훅 서명 범위의 API 키를 얻습니다.

2. 미리 서명된 송장 페이로드는 판매자의 비밀 키, 삽입 금액, 통화, 콜백 URL 및 만료 타임스탬프와 함께 HMAC-SHA256을 사용하여 서버측에서 생성됩니다.

3. 서명된 페이로드는 POST 요청을 통해 https://pay.bitfinex.com/api/v1/invoice 로 전송되어 고유한 송장 ID와 QR 코드 SVG 데이터를 반환합니다.

4. 판매자는 QR 코드를 렌더링하거나 제공된 URL을 사용하여 고객을 호스팅된 결제 페이지로 리디렉션합니다.

5. 온체인 확인에 성공하면 Bitfinex Pay는 상태, 거래 해시 및 결제 세부 정보가 포함된 JSON 개체가 포함된 등록된 웹훅 엔드포인트에 HTTP POST를 발송합니다.

정착 및 화해

1. 정산은 6시간마다 일괄적으로 이루어지며, 법정화폐 변환이 활성화된 경우 판매자가 지정한 Bitfinex 지갑이나 외부 은행 계좌에 자금이 입금됩니다.

2. 각 결제에는 원본 송장 ID, 블록 높이 및 네트워크 수수료를 제외한 순액을 참조하는 암호화된 서명 영수증이 포함됩니다.

3. 판매자는 페이지 매김 및 날짜 범위 필터가 있는 /api/v1/invoices 엔드포인트를 사용하여 과거 송장을 쿼리할 수 있습니다.

4. 실패하거나 만료된 송장은 ERR_INVOICE_EXPIRED 또는 ERR_INSUFFICIENT_CONFIRMATIONS 와 같은 오류 코드가 포함된 웹훅 알림을 자동으로 트리거합니다.

5. 환불은 판매자 대시보드 또는 /api/v1/refund 엔드포인트를 통해서만 시작되며 원본 송장 ID와 사유 코드가 필요합니다.

보안 프로토콜

1. 모든 웹훅 페이로드에는 판매자의 공유 비밀을 사용하는 원시 본문의 base64 인코딩 HMAC가 포함된 X-BFX-Signature 헤더가 포함되어 있습니다.

2. IP 허용 목록은 계정 수준에서 시행됩니다. 화이트리스트에 있는 IPv4/IPv6 범위만 송장 생성 요청을 시작할 수 있습니다.

3. 콜백 URL은 신뢰할 수 있는 CA에서 발급한 유효한 X.509 인증서와 함께 TLS 1.2 이상을 사용해야 합니다. 자체 서명된 인증서는 거부됩니다.

4. 송장 페이로드는 생성 후 15분 이내에 만료되므로 재생 공격을 방지할 수 있습니다.

5. 서명 확인에 사용되는 개인 키는 네트워크를 통해 전송되지 않으며 하드웨어 보안 모듈(HSM) 또는 동등한 보안 엔클레이브에 저장되어야 합니다.

자주 묻는 질문

Q: Bitfinex Pay는 반복 청구 또는 구독 모델을 지원합니까? A: 아니요. Bitfinex Pay는 일회성 원자 송장 결제를 위해 설계되었습니다. 반복 논리는 예약된 송장 생성을 사용하여 외부적으로 구현되어야 합니다.

Q: 판매자는 정산 중에 자동 법정화폐 변환을 비활성화할 수 있나요? 답: 그렇습니다. 판매자는 기본 지갑에 암호화폐 잔액을 유지하면서 "정산 기본 설정" 아래 대시보드를 통해 송장별로 또는 전 세계적으로 정산 통화를 구성할 수 있습니다.

Q: 블록체인 거래가 확정되었으나 유동성 부족으로 인해 최종 정산에 실패하면 어떻게 되나요? A: Bitfinex Pay는 확인 시 정산을 보장합니다. 유동성 부족은 iFinex에 의해 내부적으로 해결됩니다. 판매자는 시장 상황에 관계없이 전체 가치를 받습니다.

Q: 통합 흐름을 테스트하기 위한 샌드박스 환경이 있습니까? 답: 그렇습니다. 개발자 포털은 https://pay-staging.bitfinex.com 에서 모의 ​​블록체인 확인 및 수수료 없는 테스트 트랜잭션이 포함된 스테이징 엔드포인트를 제공합니다.