PayTabs Connector
Status: In development: its code is written and tested on its own, but it does not work end to end on the platform yet. It cannot be installed.
| Kind | Version | Publisher | Licence |
|---|---|---|---|
| Connector | 1.0.0 | ZAITRACK | Apache-2.0 |
What it does
Takes the profile's PayTabs callbacks, each verified by its signature and confirmed with PayTabs' payment query before it is trusted, in any of PayTabs' regions (Saudi Arabia, the UAE, Egypt, Oman, Jordan, …). PayTabs has no transaction list, so payments made before the installation are not read. A captured live payment for an approved carrier invoice's exact gross, in its currency, marks it paid in the freight marketplace; a test payment is recorded, not applied.
- Regions: SA, AE, EG, JO, OM
- Capabilities:
integration.payment.transaction.query,integration.payment.webhook.ingest
How to use it
Not yet: see its status above.
Configuration
| Setting | Type | Required | Allowed values and default |
|---|---|---|---|
paytabs_region | string | yes | one of SA, AE, EG, OM, JO, KW, IQ, MA, QA, GLOBAL; Where the PayTabs account is: SA, AE, EG, OM, JO, KW, IQ, MA, QA or GLOBAL (its API domain) |
paytabs_profile_id | string | yes | The profile's number, from PayTabs' dashboard (Developers → Key management) |
Credentials
Each is a secret setting of the installation: kept sealed (OpenBao in production), never shown again; Adapter Studio shows it as set.
paytabs_server_key
Limits
- Memory: 256 MB
- Time per call: 30,000 ms
- Largest message: 1,048,576 bytes
- Calls at once: 16
- Network: only
secure.paytabs.sa,secure.paytabs.com,secure-egypt.paytabs.com,secure-oman.paytabs.com,secure-jordan.paytabs.com,secure-kuwait.paytabs.com,secure-iraq.paytabs.com,secure-morocco.paytabs.com,secure-doha.paytabs.com,secure-global.paytabs.com
Troubleshooting
- Credentials refused. The secret settings must be the ones the provider issued for this account and environment (sandbox or live); give them again in Adapter Studio, since they are never shown back.
- Rate limited. The provider's limit applies to the account: calls are retried with a growing pause; spread scheduled work or ask the provider for a higher limit.
- Nothing is sent or synced. The installation must be active, its version approved; it reaches only the hosts listed under Limits.
- Webhooks rejected. The webhook secret must match the one configured at the provider; a request whose signature does not match is refused.
Source
adapters/connectors/paytabs