← Все уроки

УРОК 13 / 13

Добавь оплату картой на свою страницу криптооплаты.

Подключи свой аккаунт провайдера, проверь его и включи карты для нужных магазинов.

Что получится

Оплата картой рядом с оплатой из кошелька, с получением USDC в Base на кошелёк счёта.

1. Проверь аккаунт Coinflow

Используй Wholly Crypto 9.0.0 или новее. Попроси Coinflow одобрить твой бизнес и включить зачисление USDC в Base на отдельные адреса для каждого счёта. В рабочем режиме комиссии провайдера должен платить клиент; резервы и удержания из зачисления недопустимы.

Доступность, проверка личности, лимиты и комиссии зависят от аккаунта Coinflow и местоположения клиента. Проверь итоговую цену в Coinflow перед оплатой.

Документация Coinflow · Текущий провайдер on-ramp

2. Подключи и проверь в sandbox

Открой Settings → Fiat payments. Сохрани merchant ID Coinflow, API key и Webhook Validation Key. Добавь показанный callback URL в Coinflow, затем проверь соединение. Держи учётные данные на сервере; никогда не делись ключами кошельков.

Sandbox-оплата администратора представляет собой отдельный тест на 10 USD с тестовым адресом. Она не оплачивает рабочий счёт. Успешная проверка соединения сама по себе не подтверждает допуск бизнеса или платежа.

3. Включи USDC в Base для магазина

Сделай резервную копию кошелька проекта и проверь сканер Base. В Store → Payment methods включи нативный USDC в Base и оплату картой. Используй USDC, а не USDbC или USDC в Ethereum. Если счёт исключает USDC в Base, карты предлагаться не будут.

4. Проведи небольшой реальный платёж

После одобрения Coinflow включи рабочий режим и создай обычный счёт вручную или через API. Выбери карту при оплате. Счёт сохраняет исходную валюту, котировку и наценку; Coinflow показывает клиенту итоговые комиссии и конвертацию до оплаты.

5. Проверь получение перед выдачей заказа

Счёт считается оплаченным только после получения USDC и нужных подтверждений блокчейна. Авторизация карты или возврат на страницу оплаты не доказывает получение денег.

Проверь детали Card payment в счёте и транзакцию USDC в Base. Используй обычный процесс с подписанными IPN или вебхуками. Реагируй на invoice.settled и проверяй requires_review; не выдавай заказ только по возврату браузера. Поздние или противоречивые платежи могут требовать проверки.

API, IPN и вебхуки

6. Переведи средства и разбери исключения

Оставь ETH в Base для отправки полученного USDC на холодный кошелёк или настрой автоматическое пополнение газа и переводы. Возвраты по картам и чарджбэки обрабатывай в Coinflow. Никогда не возвращай криптовалюту отправителю транзакции провайдера. Проверяй споры в Needs attention.

Автоматический вывод средств