HyperPay
Quick Start
- Sign up at hyperpay.com and obtain API credentials
- Create a terminal in the Admin Console with the parameters below
- Start processing — the adapter is pre-built and ready to use
Overview
HyperPay — Saudi payment gateway with 100+ partner banks in the region MENA. Serves merchants in UAE, Saudi Arabia, Bahrain, Egypt and Jordan.
| Provider ID | hyperpay |
| Category | Card Processors |
| Website | hyperpay.com |
Supported operations: start_tx capture_tx payout refund_tx status
Authentication
Access Token in Bearer Auth header.
Configuration
Required Parameters
| Parameter | Description |
|---|---|
entity_id | HyperPay Entity ID (Dashboard → Integration → Entity ID) |
access_token | HyperPay Access Token (Dashboard → Integration → Access Token) |
remote_api_url | HyperPay API endpoint (by default https://eu-prod.oppwa.com/v1) |
Status Mapping
| Provider Status | 4pay Status | Description |
|---|---|---|
000.100.110 | charged | Successful payment |
000.100.112 | authorized | Successful authorization |
000.200.000 | refunded | Successful refund |
000.200.100 | refunded | Refund processed |
000.000.000 | charged | General success |
800.400.500 | failed | Declined |
800.400.501 | failed | Declined (CVV) |
800.400.502 | failed | Declined (card) |
800.100.151 | failed | Error |
800.100.152 | failed | Error |
800.100.153 | failed | Error |
800.100.170 | rejected | Declined (risk) |
800.100.171 | rejected | Declined (risk) |
800.100.172 | rejected | Declined (risk) |
PENDING | pending | Processing |
000.100.* | charged | |
000.200.* | refunded | |
000.* | charged | |
800.* | failed | |
900.* | failed | |
_unknown_ | pending |