Поддержка POLi, PayID, банковского перевода и AUD в казино-платформах

Введение

Австралийские игроки предпочитают локальные платёжные методы: мгновенные банковские переводы через POLi, PayID/Osko в рамках NPP и традиционный банк-трансфер, всё в AUD. Для оператора важно обеспечить бесшовную интеграцию, мгновенную обработку, соответствие регуляциям и надёжную архитектуру.

1. Обзор платёжных методов

1. POLi Payments

OAuth-авторизация пользователя через интерфейс банка, без карт и дополнительно SMS-кодов.
Мгновенное зачисление средств, подходит для депозитов.

2. PayID/Osko (NPP)

Перевод по идентификатору (email, телефон), сетевой стандарт NPP обеспечивает расчёт в течение секунд.
Требует интеграции с PSP, поддерживающим Australia’s New Payments Platform.

3. Банковский перевод (BPAY / прямой transfer)

BPAY: генерация Biller Code и Customer Reference, оплату проводит пользователь в интернет-банке; зачисление до 24 ч.
Прямой AUD-transfer: SWIFT/IBAN перевод, подходят для крупных сумм, время обработки 1–3 рабочих дня.

4. Валюта AUD

Все операции в AUD: корретное отображение, хранение в базе, округление до центов (`DECIMAL(12,2)`).

2. Архитектура интеграции

```mermaid
flowchart LR

Player -->	initiate deposit	API-Gateway
API-Gateway --> PaymentService
PaymentService -->	init POLi	POLi-API
PaymentService -->	init PayID	PSP-API
PaymentService -->	generate BPAY	BillingService
POLi-API -->	webhook	PaymentService
PSP-API -->	webhook	PaymentService
BillingService -->	polling / webhook	PaymentService
PaymentService --> TransactionService
TransactionService --> AuditDB
```

API-Gateway: валидация, rate-limiting, маршрутизация к PaymentService.
PaymentService: унифицированная точка для всех AUD-методов, хранит `paymentId`, `method`, `status`, `metadata`.
BillingService: модуль для BPAY-счётов и polling статусов.
TransactionService: ACID-транзакции обновляют баланс и логируют операции.
AuditDB: неизменяемое хранилище логов запросов и ответов.

3. Реализация POLi

1. Инициация:

```http
POST /api/payments/poli/init
{
"amount": 100.00,
"currency": "AUD",
"returnUrl": "https: //casino.com/poli/callback"
}
```

→ `{ paymentId, poliUrl }`

2. Перенаправление игрока:

Игрок перенаправляется на `poliUrl`, авторизуется в банке, подтверждает платёж.

3. Webhook-обработка:

```http
POST /api/payments/poli/callback
Headers: X-Signature
Body: { paymentId, status, bankTransactionId }
```

Проверка HMAC по `X-Signature`.
Обновление `status`: `pending` → `approved`/`declined`.
При `approved` — запуск `TransactionService.credit(playerId, amount)`.

4. Реализация PayID/Osko

1. Инициация:

```http
POST /api/payments/payid/init
{
"payId": "user@example.com",
"amount": 250.00,
"currency": "AUD",
"Дескрипшен": "Casino deposit"
}
```

→ `{ paymentId, transactionRef }`

2. Webhook-уведомление:

PSP шлёт `POST /api/payments/payid/callback { paymentId, status }`.

Аналогичная проверка подписи.
Статусы: `pending`, `settled`, `failed`.

5. Реализация BPAY и банковского перевода

1. Генерация счёта BPAY:

```http
POST /api/payments/bpay/generate
{ "amount": 500.00 }
```

→ `{ billerCode, customerRef, expiryDate }`

2. Polling статусов:

`GET /api/payments/bpay/status?billerCode=&customerRef=` каждые 15 минут.
При `PAID` — update `approved`, credit funds.

3. Прямой банковский перевод:

Отображение реквизитов счета (SWIFT, BSB, Account) в UI.
Операции сверяются вручную или автоматически по incoming bank statements через SFTP.

6. Локализация и UX

Форматирование:

```js
new Intl.NumberFormat('en-AU', { style: 'currency', currency: 'AUD' }).format(1000)
// "A$1,000.00"
```

UI:

Выбор метода в депозите: иконки POLi, PayID, BPAY, Bank Transfer.
Описание сроков и комиссий под каждым методом.
Верификация перед первым вводом: KYC/AML.

7. Безопасность и отказоустойчивость

8. Тестирование

Sandbox-режимы:

POLi: `poli.sandbox.domain` с фейковыми токенами `test_user`.
PSP: тестовые креды у провайдеров PayID.
E2E-тесты (Cypress): сценарии: инициировать → эмулировать callback → проверить баланс.
Load Testing (k6): имитация 1000 concurrent депозитов методом POLi и PayID.

Заключение