Skip to content

OmegaPay API (1.0.106)

Задача: Интеграция платежной системы с поддержкой нескольких методов.
Рекомендация по реализации: Выполняйте интеграцию каждого платежного метода отдельно, следуя приведенным ниже пунктам.

Список требований к интеграции:
Базовая интеграция

Реализовать общую интеграцию с платежной системой (ПС).
Панель управления методами
Создать админ-панель для управления платежными методами.
Реализовать возможность создавать новые методы с указанием поля payment_method (например: basic_card, P2P-card, pix и т.д.).

Лимиты сумм
Для каждого метода должны быть настраиваемые лимиты: минимальная и максимальная сумма платежа.

Округление сумм
Реализовать функцию округления суммы платежа в зависимости от метода.
Особое внимание для P2P-платежей: Для валют, таких как гривна (UAH) и аргентинское песо (ARS), сумма должна передаваться только в целых числах. Это предотвратит проблемы с зачислением средств из-за ручного округления со стороны пользователей.

Обработка колбэков (вебхуков)
Реализовать возможность обновления статуса платежа через колбэк.

Пример сценария:
Пользователь совершает P2P-платеж, который завершается ошибкой.
Автоматически приходит вебхук со статусом DECLINE.
После ручной проверки оператором инициируется повторная отправка вебхука со статусом COMPLETED.
При получении статуса COMPLETED баланс пользователя должен пополниться автоматически.

Экранирование данных
Реализовать экранирование имени владельца карты, которое передается в вебхуке. Это необходимо для корректной обработки имен с особыми символами (например, греческими).

Процесс тестирования
Категорически рекомендуется выполнить полную реализацию и тестирование на дев-стендах.
После успешного тестирования необходимо проверить работоспособность на продакшн-среде.

Download OpenAPI description
openapi.json
openapi.yaml
Overview
License

Apache-2.0

Languages
Servers
Mock server

https://docs.omegapay.tech/_mock/openapi/

Sandbox

https://CONTACT_YOUR_MANAGER/

Production

https://CONTACT_YOUR_MANAGER/

Payments

Payments API

OperationsWebhooks

Error codes

CodeDescription
1.00Illegal Workflow State
1.01Not Found
1.02Communication Problem
1.03Internal Server Error
1.04Cancelled by Timeout
1.05Terminal not Found
1.06Recurring Token not Found
1.07Payer Unaccepted
1.08Invalid Amount
1.09Invalid Currency
1.10Insufficient Balance
2.00Cancelled by Customer
3.00Declined by Acquirer
3.01Declined by Acquirer: Anti-fraud
3.02Declined by Acquirer: Request Validation
3.03Acquirer Malfunction
3.04Acquirer Timeout
3.05Acquirer Limits Reached
3.06Declined by Acquirer: Card Scheme
3.07Declined by Acquirer: Card Data
3.08Declined by Acquirer: Business Rules
3.09Not Fully 3DS
3.10Unknown Error Code
3.11Payer cannot pay
3.12Invalid ID Document
3.13ID Document Restrictions
3.14Declined Due to Age Requirements
3.15ID Document Under Temporary Restrictions
3.16Duplicate Payment
3.17Channel not active
3.18Cancelled or abandoned transaction
3.19Card PAN blacklisted
3.20Card PAN not whitelisted
3.21Invalid mobile number
3.22Card BIN country not allowed
3.23Bank not supported
4.00Declined by Issuer
4.01Insufficient Funds
4.02Do Not Honor
4.03Invalid Account Number
4.04Declined by Issuer: Invalid card expiration date
4.05Issuer Limits Reached
4.06Card not active
4.07Invalid Security Code
4.08Declined by Issuer: Business Rules
4.09Declined by Issuer: Anti-fraud
4.10Transaction not permitted to cardholder
4.11AVS failed
5.00Declined by 3DS
5.013DS Timeout
5.02ACS malfunction
6.00Declined by Internal Anti-fraud
6.01Card PAN Blacklisted
6.02Customer Email Blacklisted
6.03Card Issuing Country Restricted
6.04IP Country Restricted
6.05Restricted Currency
6.06Invalid Amount
6.07IP Country Must Be Equal to Billing Country
6.08IP Country Must Be Equal to Card Issuing Country
6.09Billing Country Must Be Equal to Card Issuing Country
6.10Payment Created Within Closed Period of Day
6.11Card PAN not Whitelisted
6.12Cardholder name is invalid
6.13The same card is used by different customers
6.14Customer Phone Blacklisted
6.15Card Brand not supported
6.21Limit exceeded: Number of completed deposits
6.22Limit exceeded: Number of completed deposits for card
6.23Limit exceeded: Number of declined deposits for card
6.24Limit exceeded: Number of cards for IP address
6.25Limit exceeded: Number of IP addresses for card
6.26Limit exceeded: IP country does not match card country
6.27Limit exceeded: Same amount and currency for card
6.28Limit exceeded: Amount of deposits in specified currency
6.29Limit exceeded: Amount of deposits for card and currency
6.30Limit exceeded: Amount of deposits in base currency
6.31Limit exceeded: Amount of deposits for card in base currency
6.32Limit exceeded: Number of IP countries for card
6.33Limit exceeded: Amount of deposits for customer in base currency
6.34Limit exceeded: Withdrawal amount for customer in base currency
6.35Billing Country Restricted
6.36Customer Citizenship Country Restricted
6.37Limit exceeded: Number of withdrawals
6.38Limit exceeded: Amount of withdrawals in specified currency
6.39Card BIN Blacklisted
6.40UPI VPA Blacklisted
6.41ID Document Blacklisted
6.42Limit exceeded: Decline deposits streak for card
6.43Limit exceeded: Incomplete deposits APM streak for email
6.44Customer email contains restricted word
6.45Limit exceeded: Pending deposits for customer
6.46Limit exceeded: Pending same amount deposits for customer
6.47Limit exceeded: Number of completed deposits for email
6.48Limit exceeded: Number of completed deposits for IP address
7.00Declined by External Anti-fraud
7.01External Anti-fraud Communication Problem

Testing

For a successful deposit in the sandbox environment, the amount should be less than 10000000. For test withdrawals and refunds, the limit is 10000.

Test cards

Card NumberResult
4000 0000 0000 00023D-Secure enrolled, successful authorization
4242 4242 4242 42423D-Secure enrolled, declined authorization
4000 0000 0000 0408Not enrolled for 3D-Secure, successful authorization
4000 0000 0000 0416Not enrolled for 3D-Secure, declined authorization