aid: paytabs
url: https://raw.githubusercontent.com/api-evangelist/paytabs/refs/heads/main/apis.yml
name: PayTabs
kind: company
description: PayTabs is a Saudi-built payment orchestration and gateway provider
  serving merchants across MENA. The PT2 REST API accepts cards and local methods
  (mada, Meeza, KNET, OmanNet, Benefit, STC Pay, urpay) plus Apple Pay, Google Pay
  and Samsung Pay through hosted, managed and own-form flows, with tokenization,
  recurring billing and invoicing. The API is served on region-specific hosts and
  authenticated with a merchant server key.
image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/apis-json-logo.jpg
tags:
- Payments
- Payment Gateway
- Fintech
- MENA
- Saudi Arabia
- Cards
- mada
created: '2026-07-17'
modified: '2026-07-17'
specificationVersion: '0.19'
apis:
- aid: paytabs:paytabs-hosted-payment-page-api
  name: PayTabs Hosted Payment Page API
  tags:
  - Payments
  - Hosted Payment Page
  - Redirect
  image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/apis-json-logo.jpg
  humanURL: https://docs.paytabs.com/manuals/PT-API-Endpoints/Integration-Types-Manuals/Hosted-Payment-Page/HPP-Step-3-Initiating-Payment/HPP-Initiating-Payment/
  baseURL: https://secure.paytabs.com
  properties:
  - url: https://docs.paytabs.com/manuals/PT-API-Endpoints/Introduction/
    type: Documentation
  - url: https://documenter.getpostman.com/view/14575178/TWDRtfWG
    type: APIReference
  - url: openapi/paytabs-openapi.yml
    type: OpenAPI
  - url: collections/paytabs.postman_collection.json
    type: PostmanCollection
  description: Creates a transaction via POST /payment/request and returns a
    hosted redirect_url where the customer completes payment on PayTabs-hosted,
    PCI-scope-reducing pages. Supports cards, mada, Apple/Google/Samsung Pay and
    local methods, with callback (IPN) and return URLs.
- aid: paytabs:paytabs-managed-form-api
  name: PayTabs Managed Form API
  tags:
  - Payments
  - Managed Form
  - iFrame
  image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/apis-json-logo.jpg
  humanURL: https://docs.paytabs.com/PT2-API-Endpoints/Integration-Types-Manuals/Hosted-Payment-Page/HPP-Step-2-Configure-Integration-Method/HPP-Step-2-Landing/
  baseURL: https://secure.paytabs.com
  properties:
  - url: https://docs.paytabs.com/manuals/PT-API-Endpoints/Introduction/
    type: Documentation
  - url: openapi/paytabs-openapi.yml
    type: OpenAPI
  - url: collections/paytabs.postman_collection.json
    type: PostmanCollection
  description: Same POST /payment/request flow rendered inside a merchant-page
    iframe (framed=true) so the checkout is embedded while card capture stays in
    PayTabs' PCI scope.
- aid: paytabs:paytabs-own-form-api
  name: PayTabs Own Form API
  tags:
  - Payments
  - Own Form
  - Tokenization
  image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/apis-json-logo.jpg
  humanURL: https://docs.paytabs.com/manuals/PT-API-Endpoints/Integration-Types-Manuals/Own-Form/Own-Form-Step-5-handle-the-payment-response/Own-Form-Step-5-Landing/
  baseURL: https://secure.paytabs.com
  properties:
  - url: https://docs.paytabs.com/manuals/PT-API-Endpoints/Introduction/
    type: Documentation
  - url: openapi/paytabs-openapi.yml
    type: OpenAPI
  - url: collections/paytabs.postman_collection.json
    type: PostmanCollection
  description: Merchant-branded checkout that collects card data on the merchant
    page (client key) and submits to POST /payment/request, requiring a higher
    PCI SAQ level than the hosted flows.
- aid: paytabs:paytabs-transaction-management-api
  name: PayTabs Transaction Management API
  tags:
  - Transactions
  - Query
  - Refund
  - Capture
  image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/apis-json-logo.jpg
  humanURL: https://docs.paytabs.com/manuals/PT-API-Endpoints/Integration-Types-Manuals/Hosted-Payment-Page/HPP-Step-7-Manage-Transactions/HPP-Step-7-Query-Transaction/
  baseURL: https://secure.paytabs.com
  properties:
  - url: https://docs.paytabs.com/manuals/PT-API-Endpoints/Integration-Types-Manuals/Hosted-Payment-Page/HPP-Step-7-Manage-Transactions/HPP-Step-7-Query-Transaction/
    type: Documentation
  - url: openapi/paytabs-openapi.yml
    type: OpenAPI
  - url: collections/paytabs.postman_collection.json
    type: PostmanCollection
  description: Reads transaction state via POST /payment/query (by tran_ref or
    cart_id) and performs follow-up actions - capture, void, release and refund -
    via POST /payment/request with the matching tran_type.
- aid: paytabs:paytabs-token-recurring-api
  name: PayTabs Token & Recurring Billing API
  tags:
  - Tokenization
  - Recurring
  - Repeat Billing
  image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/apis-json-logo.jpg
  humanURL: https://docs.paytabs.com/manuals/PT-API-Endpoints/Repeat-Billing/Step-1-Understanding-Workflow-&-Prerequisites/Repeat-Billing-Prerequisites/
  baseURL: https://secure.paytabs.com
  properties:
  - url: https://docs.paytabs.com/manuals/PT-API-Endpoints/Repeat-Billing/Step-1-Understanding-Workflow-&-Prerequisites/Repeat-Billing-Prerequisites/
    type: Documentation
  - url: openapi/paytabs-openapi.yml
    type: OpenAPI
  - url: collections/paytabs.postman_collection.json
    type: PostmanCollection
  description: Saves a card token (tokenise/register) then charges it for
    unattended recurring or repeat-billing payments via POST /payment/request
    with tran_class=recurring and the stored token.
- aid: paytabs:paytabs-invoices-api
  name: PayTabs Invoices API
  tags:
  - Invoices
  - Payment Links
  image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/apis-json-logo.jpg
  humanURL: https://support.paytabs.com/en/support/solutions/articles/60000902481-3-2-3-invoices-apis-initiating-the-payment-request-download-invoice-pdf
  baseURL: https://secure.paytabs.com
  properties:
  - url: https://support.paytabs.com/en/support/solutions/articles/60000902481-3-2-3-invoices-apis-initiating-the-payment-request-download-invoice-pdf
    type: Documentation
  - url: openapi/paytabs-openapi.yml
    type: OpenAPI
  - url: collections/paytabs.postman_collection.json
    type: PostmanCollection
  description: Generates payable invoices / payment links over POST /payment/request
    with invoice fields, deliverable to customers and downloadable as PDF or sent
    via SMS.
common:
- type: AgenticAccess
  url: agentic-access/paytabs-agentic-access.yml
- type: TrustCenter
  url: security/paytabs-trust-center.yml
- type: VulnerabilityDisclosure
  url: security/paytabs-vulnerability-disclosure.yml
- type: DomainSecurity
  url: security/paytabs-domain-security.yml
- type: Authentication
  url: authentication/paytabs-authentication.yml
- type: GitHubOrganization
  url: https://github.com/paytabscom
- type: LinkedIn
  url: https://www.linkedin.com/company/paytabs
- type: Website
  url: https://paytabs.com/en/
- type: Documentation
  url: https://docs.paytabs.com/
- type: Plans
  url: plans/paytabs-plans-pricing.yml
- type: RateLimits
  url: rate-limits/paytabs-rate-limits.yml
- type: FinOps
  url: finops/paytabs-finops.yml
- url: https://paytabs.com/news/
  type: Blog
- type: DeveloperPortal
  url: https://docs.paytabs.com/
- type: GettingStarted
  url: https://docs.paytabs.com/PT2-API-Endpoints/Introduction/
- type: APIReference
  url: https://documenter.getpostman.com/view/14575178/TWDRtfWG
- type: Postman
  url: https://documenter.getpostman.com/view/14575178/TWDRtfWG
- type: Support
  url: https://support.paytabs.com/en/support/home
- type: Pricing
  url: https://paytabs.com/en/pricing/
- type: SignUp
  url: https://merchant.paytabs.com/merchant/register
- type: TermsOfService
  url: https://ai.paytabs.com/en/terms-of-use/
- type: PrivacyPolicy
  url: https://ai.paytabs.com/en/privacy-policy/
- type: StatusPage
  url: https://status.paytabs.com/
- type: Security
  url: https://ai.paytabs.com/en/security-compliance/
- type: Compliance
  url: https://ai.paytabs.com/en/security-compliance/
- type: Packages
  url: packages/paytabs-packages.yml
- type: SDKs
  url: packages/paytabs-packages.yml
- type: MCPServer
  url: mcp/paytabs-mcp.yml
- type: LLMsTxt
  url: llms/paytabs-llms.txt
- type: Overlay
  url: overlays/paytabs-openapi-overlay.yaml
- type: Conformance
  url: conformance/paytabs-conformance.yml
- type: ErrorCatalog
  url: errors/paytabs-problem-types.yml
- type: DeclineCodes
  url: errors/paytabs-decline-codes.yml
- type: Lifecycle
  url: lifecycle/paytabs-lifecycle.yml
- type: Conventions
  url: conventions/paytabs-conventions.yml
- type: Idempotency
  url: conventions/paytabs-conventions.yml
- type: DataModel
  url: data-model/paytabs-data-model.yml
- type: AsyncAPI
  url: asyncapi/paytabs-webhooks-asyncapi.yml
- type: Webhooks
  url: asyncapi/paytabs-webhooks-asyncapi.yml
- type: Sandbox
  url: sandbox/paytabs-sandbox.yml
- type: AgentSkill
  url: skills/_index.yml
maintainers:
- FN: Kin Lane
  email: kin@apievangelist.com