Индонезия
Локальные способы оплаты в IDR
Перед тем как начать
Авторизация
Как подписывать запросы API-токеном.
Создание платежа
Базовый запрос на создание заказа, который расширяет эта страница.
Этот способ оплаты доступен не всем мерчантам. Уточните доступность у вашего менеджера.
Обзор
| Валюта | Способ оплаты |
|---|---|
IDR | Локальные банковские способы и кошельки |
Плательщик перенаправляется на paymentLink и выбирает способ оплаты на странице провайдера.
Чем отличается от обычного заказа
Заказ создаётся через стандартный эндпоинт POST /v1/orders. Базовые поля (amount, currency, successUrl, failUrl, callbackUrl и т. д.) такие же, как у обычного заказа; дополнительно к ним передаётся объект customer с данными плательщика.
| Поле | Тип | Описание |
|---|---|---|
customer | object | Данные плательщика. Набор обязательных полей приведён ниже |
Для этого способа оплаты поле externalUserId обязательно.
Поля объекта customer
| Поле | Тип | Обязательное | Описание |
|---|---|---|---|
phone | string | ✅ Да | Номер телефона: 10–13 цифр, начинается с 08 или 628 |
email | string | ✅ Да | Email плательщика |
firstName | string | ✅ Да | Имя, должно совпадать с владельцем номера телефона |
lastName | string | ✅ Да | Фамилия, должна совпадать с владельцем номера телефона |
Передавайте реальные данные плательщика. Имена и номера телефонов сверяются с владельцем номера на стороне провайдера; при несовпадении платежи отклоняются.
Пример запроса
{
"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, чтобы он завершил оплату.