Коллекция ресурсов для разработчиков цифровых кошельков Вьетнама
Ниже представлена подборка ресурсов для разработчиков цифровых кошельков во Вьетнаме, охватывающая основные платежные платформы, документацию по API, технические спецификации и информацию о поддержке локализации, чтобы помочь разработчикам быстро выйти на вьетнамский рынок:
I. Основные вьетнамские цифровые кошельки и порталы разработчиков
-
Кошелек Momo
- Официальный сайт. https://momo.vn
- Документация для разработчиков. Портал для разработчиков Momo
- Поддерживает API для платежей, переводов, генерации QR-кодов и т. д.
- Среда "песочницы" предоставляет инструменты для тестирования
-
ZaloPay
- Официальный сайт. https://zalopay.vn
- Документация API. Открытый API ZaloPay
- Руководство по интеграции (с примерами кода на Java/PHP)
-
ViettelPay (Опыт работы в телекоммуникационных компаниях)
- Центр разработчиков. Цифровые услуги Viettel
-
VNPAY (Программа банковского союза)
- Шлюз API. Руководство по интеграции VNPAY
II. Ключевые технологии и требования к соответствию
-
сертификация безопасности
- Соответствие стандарту PCI DSS (при обработке данных кредитных карт)
Ссылка:Стандарты безопасности Национального банка Вьетнама
- Соответствие стандарту PCI DSS (при обработке данных кредитных карт)
-
Стандарты QR-кодов
Используйте спецификацию Вьетнамского общего QR-кода:VMQR
(Совместимость с международным стандартом EMVCo) -
Основные функции Интерфейс Репозиторий образцов кода (Github)::
Пример генерации QR-кода # Momo (Python)
запросы на импорт
api_endpoint = "https:/payment.momo/v1/generate-qr"
headers = {"X-Access-Key": "YOUR_KEY"}.
данные = {
"сумма": 100000.
"orderId": "ORDER_123",
"redirectUrl": "your_callback_url"
}
response = requests.post(api_endpoint, json=data, headers=headers)
III. Маршрут приложения для тестового аккаунта в песочнице
| Платформы | Запросить ссылку | Испытать лимит суммы |
|————|———————————–|——————|
| ZaloPay | developers.zalopay/sandbox-signup | ≤500,000 VND/ручка |
| Momo | momo.dev/sandbox-request | ≤200,000 VND/ручка |
IV. Соображения локализации
- Языковая поддержка: пользовательский интерфейс должен быть на вьетнамском языке по умолчанию + английский по желанию
2.Модель платы за обслуживание:: Как правило, 0,51 TP3T-1,1 TP3T транзакций (выше для трансграничных платежей)
3.API "Горячие сценарии:
-Пополните счет за телефон (пополнение счета
) / оплата коммунальных счетов (оплата по счету
)
4. аутентификация пользователя: требуется стыковкаeKYC
Такие услуги, как [VNG ID](( https ://id .vng.com .vn ))
Рекомендуется присоединиться к официальному сообществу разработчиков (группа в Facebook или форум) для получения последних обновлений политики и технической поддержки.
Ниже представлено расширенное дополнение к ресурсу для разработчиков цифровых кошельков Вьетнама, включающее более практичные инструменты, детали политики и советы по экологическому выравниванию:
V. Ресурсы и инструменты для передовых разработок
-
Официальная библиотека SDK
- Momo SDK для Android/iOS: репозитории GitHub предоставляютОбразцы проектов
- ZaloPay Webhook Debugging Tool: Моделирование обратных запросов в реальном времени (требуется вход в бэкэнд разработчика)
-
Сторонние библиотеки для упаковки (поддержка сообщества)
// Неофициальный пакет VNPAY для Node.js (npm install)
const vnpay = require('vnpay-sdk');
const client = new vnpay.Client({
merchantCode: 'YOUR_MERCHANT_ID',
secureSecret: 'YOUR_HASH_KEY'
});
-
Коллекция API Postman
Многие платформы предоставляют предварительно сконфигурированные файлы окружения Postman:
VI. Соответствие требованиям и докинг банков Ключевые моменты
-
Лицензии на трансграничные платежи
Если речь идет о международном сборе, требуется дополнительная лицензия (ссылка)SBV № 21/2024) -
Требования к интерфейсу для борьбы с отмыванием денег (AML)
Одна из систем аутентификации, требуемая правительством, должна быть интегрирована:- Национальная платформа eKYC (Прямая ссылка на базу данных "Гражданин")
-
Образец кода API для обработки налоговых сборов:
// Расчет местного НДС во Вьетнаме (для бизнес-счетов)
public double calculateVAT(double amount, String serviceType) {
double rate = switch(serviceType) {
case "DOMESTIC_PAYMENT" -> 0.01; // 1% НДС
case "CROSS_BORDER" -> 0,05; // НДС 5%
default -> throw new IllegalArgumentException();
};
вернуть сумму * ставку.
}
VII. Рекомендации по оптимизации производительности
| Место действия | Рекомендуемые решения |
|———————|———————————–|
| Высокочастотная генерация QR-кодов | CDN-кэширование + механизм предварительной генерации |
| Задержка OTP | Доступ к нескольким операторам связи (SMS-шлюз, такой какVinSMS) |
| Webhook timeout | AWS Lambda Vietnam Node Deployment (ап-юго-восток-1
) |
VIII. Альтернативные программы и резервные поставщики услуг
- Автоматическое переключение неудачных сделокДоступ к следующим альтернативным шлюзам возможен:
график LR.
A[главный канал:Момо] --> B{код состояния ≠ 200}.
B --> C [понижение рейтинга до ZaloPay].
C --> D [возможный откат к банковскому переводу].
2.Нишевые, но быстро развивающиеся API кошельков:
- ShopeePay (преимущество сценария электронной коммерции)
- GrabPay Вьетнам
IX, навыки отладки и таблица общих кодов ошибок
Типичные ошибки и их решения:
| Коды состояния HTTP | Коды ошибок Momo | Значение | Меры противодействия |
|————|————