Skip to main content

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.

KindVersionPublisherLicence
Connector1.0.0ZAITRACKApache-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​

SettingTypeRequiredAllowed values and default
paytabs_regionstringyesone 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_idstringyesThe 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