← Wszystkie poradniki

PORADNIK 13 / 13

Dodaj płatności kartą do swojego checkoutu krypto.

Połącz własne konto dostawcy, przetestuj je i włącz karty w wybranych sklepach.

Co uzyskasz

Checkout kartą obok płatności portfelem, z USDC w Base trafiającym do portfela faktury.

1. Sprawdź konto Coinflow

Użyj Wholly Crypto 9.0.0 lub nowszego. Poproś Coinflow o zatwierdzenie firmy i włączenie rozliczeń USDC w Base na osobne adresy każdej faktury. Produkcja wymaga opłat dostawcy po stronie klienta, bez rezerw ani potrąceń z rozliczenia.

Dostępność, weryfikacja tożsamości, limity i opłaty zależą od konta Coinflow i lokalizacji klienta. Przed zapłatą sprawdź końcową cenę w Coinflow.

Dokumentacja Coinflow · Obecny dostawca on-ramp

2. Połącz i przetestuj w sandboxie

Otwórz Settings → Fiat payments. Zapisz merchant ID Coinflow, API key i Webhook Validation Key. Dodaj wyświetlony adres callback w Coinflow, a potem sprawdź połączenie. Trzymaj dane dostępowe na serwerze; nigdy nie udostępniaj kluczy portfeli.

Checkout sandbox administratora to osobny test na 10 USD z testowym adresem odbiorczym. Nie opłaca faktury produkcyjnej. Sam udany test połączenia nie potwierdza dopuszczenia firmy ani płatności.

3. Włącz USDC Base w sklepie

Zrób kopię portfela projektu i sprawdź skaner Base. W Store → Payment methods zaakceptuj natywne USDC w Base i włącz karty. Użyj USDC, nie USDbC ani USDC w Ethereum. Faktura wykluczająca USDC Base nie pokaże kart.

4. Wypróbuj małą rzeczywistą płatność

Po zatwierdzeniu przez Coinflow włącz produkcję i utwórz zwykłą fakturę ręcznie lub przez API. Wybierz kartę w checkoucie. Faktura zachowuje pierwotną walutę, wycenę i spread; Coinflow pokazuje klientowi końcowe opłaty i przeliczenie przed zapłatą.

5. Sprawdź odbiór przed realizacją zamówienia

Faktura jest rozliczana dopiero po otrzymaniu USDC i spełnieniu twojej polityki potwierdzeń blockchaina. Autoryzacja karty ani powrót do checkoutu nie są dowodem zapłaty.

Sprawdź szczegóły Card payment faktury i transakcję USDC w Base. Zachowaj zwykły proces z podpisanymi IPN lub webhookami. Reaguj na invoice.settled i sprawdzaj requires_review; nigdy nie realizuj zamówienia tylko po powrocie przeglądarki. Spóźnione lub sprzeczne płatności mogą wymagać kontroli.

API, IPN i webhooki

6. Przenieś środki i obsłuż wyjątki

Zostaw ETH w Base na wysłanie USDC do zimnego portfela albo ustaw automatyczne finansowanie gazu i transfery. Zwroty kartowe i chargebacki obsługuj w Coinflow. Nigdy nie zwracaj krypto do nadawcy transakcji dostawcy. Spory sprawdzaj w Needs attention.

Automatyczny sweep