Индонезия

Перед тем как начать

Обзор

Плательщик перенаправляется на paymentLink и выбирает способ оплаты на странице провайдера.

Чем отличается от обычного заказа

Заказ создаётся через стандартный эндпоинт POST /v1/orders. Базовые поля (amount, currency, successUrl, failUrl, callbackUrl и т. д.) такие же, как у обычного заказа; дополнительно к ним передаётся объект customer с данными плательщика.

Поля объекта customer

Пример запроса

{
  "purpose": "Payment for order #1234",
  "amount": "5000",
  "currency": "IDR",
  "externalId": "23456789",
  "externalUserId": "437568",
  "successUrl": "https://example.com/success",
  "failUrl": "https://example.com/fail",
  "callbackUrl": "https://example.com/webhooks/payments",
  "customer": {
    "lastName": "Santoso",
    "firstName": "Budi",
    "email": "budi.santoso@example.com",
    "phone": "6281245907765"
  }
}

Ответ

В ответе возвращается стандартный объект заказа. Заказ создаётся со статусом CREATED; перенаправьте плательщика на paymentLink, чтобы он завершил оплату.

Следующие шаги

H2H и платёжная форма

Для нужного метода менеджер должен включить H2H. Запрос создания заказа остаётся прежним, кроме дополнительных полей, указанных ниже. Откройте полученный paymentLink: платёжная форма платформы покажет QR-код, банковские реквизиты или действие для кошелька и дождётся результата. Прежняя интеграция с платёжной страницей остаётся доступной.

H2H поддерживает QRIS; виртуальные счета BRI, BNI, Mandiri, Permata, CIMB и BCA; кошельки OVO, DANA, DANA2 и LinkAja. Метод задаётся на терминале. QRIS показывает 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 — заказ уже недоступен для оплаты.