Филиппины
Локальные способы оплаты в PHP
Перед тем как начать
Авторизация
Как подписывать запросы API-токеном.
Создание платежа
Базовый запрос на создание заказа, который расширяет эта страница.
Этот способ оплаты доступен не всем мерчантам. Уточните доступность у вашего менеджера.
Обзор
| Валюта | Способ оплаты |
|---|---|
PHP | Локальные банковские способы и кошельки |
Плательщик перенаправляется на paymentLink и выбирает способ оплаты на странице провайдера.
Чем отличается от обычного заказа
Только валютой: объект customer не требуется. Создайте обычный заказ в PHP.
Для этого способа оплаты поле externalUserId обязательно.
Пример запроса
{
"purpose": "Payment for order #1234",
"amount": "5000",
"currency": "PHP",
"externalId": "23456789",
"externalUserId": "437568",
"successUrl": "https://example.com/success",
"failUrl": "https://example.com/fail",
"callbackUrl": "https://example.com/webhooks/payments"
}Ответ
В ответе возвращается стандартный объект заказа. Заказ создаётся со статусом CREATED; перенаправьте плательщика на paymentLink, чтобы он завершил оплату.
Поля объекта заказа
Следующие шаги
Статус заказа и webhook-уведомления
Получайте уведомления о завершении оплаты.
Платежи по странам
Другие страны и способы оплаты.
H2H и платёжная форма
Для нужного метода менеджер должен включить H2H. Запрос создания заказа остаётся прежним, кроме дополнительных полей, указанных ниже. Откройте полученный paymentLink: платёжная форма платформы покажет QR-код, банковские реквизиты или действие для кошелька и дождётся результата. Прежняя интеграция с платёжной страницей остаётся доступной.
H2H поддерживает GCash, GCash2, Maya, GrabPay, QRPH и виртуальные счета. Объект customer не требуется. В зависимости от настроенного метода форма показывает кнопку кошелька, QR-код или номер счёта. QR показывается только тогда, когда его возвращает метод оплаты.
Получение QR через API
Если метод выдаёт QR-код, запросите его содержимое после создания заказа:
curl -X POST "https://api.panel.valutix.kz/v1/orders/{orderId}/h2h/qr" \
-H "x-api-token: YOUR_API_TOKEN"{ "qrPayload": "RAW_PAYMENT_QR_PAYLOAD" }Сгенерируйте изображение QR из qrPayload, сохранив содержимое без изменений. Ручка доступна только при включённом H2H и для метода, который действительно возвращает QR: ссылка кошелька или подтверждение на телефоне не являются QR-реквизитами. Не подменяйте отсутствующий QR значением paymentLink. Дождитесь итогового статуса или колбэка: получение реквизитов не означает оплату.
Получение реквизитов через API
curl -X POST "https://api.panel.valutix.kz/v1/orders/{orderId}/h2h/bank-transfer" \
-H "x-api-token: YOUR_API_TOKEN"Ответ содержит accountNumber, accountName, bankName, bankCode, amount, currency и details. Отсутствующие необязательные значения равны null. Показывайте все поля из details, включая отделение банка и назначение перевода. Повторные запросы используют тот же платёж. HTTP 503 означает, что реквизиты ещё не готовы: повторите запрос через несколько секунд. HTTP 400 — метод не выдаёт банковские реквизиты либо заказ тестовый, 404 — заказ не найден, 409 — заказ уже недоступен для оплаты.