Geidea

Geidea is a Saudi-headquartered fintech and payments platform serving merchants across the MENA region (Saudi Arabia, Egypt, and the UAE). Its Payment Gateway lets merchants accept card and wallet payments through a hosted Geidea Checkout (HPP) page or a server-to-server Direct API for PCI-DSS-compliant merchants, covering the full transaction lifecycle - create session, 3-D Secure authentication, pay, capture, void, refund, cancel, tokenization, Pay by Link, and Pay by Invoice - with support for mada, Visa, Mastercard, Apple Pay, Google Pay, Meeza QR, and BNPL. Payments are authenticated with a merchant public key and API password over HTTP Basic auth plus an HMAC request signature, and results are delivered back to merchants via webhook (callback) notifications.

6 APIs 0 Features

PaymentsPayment GatewaySaudi ArabiaEgyptMENAmadaCardsPOSCheckoutFintech

GitHubOrganization

Sources

opencollection: 1.0.0
info:
  name: Geidea Payment Gateway API
  version: '1.0'
request:
  auth:
    type: basic
    username: '{{merchantPublicKey}}'
    password: '{{apiPassword}}'
items:
- info:
    name: Checkout
    type: folder
  items:
  - info:
      name: Create Session
      type: http
    http:
      method: POST
      url: https://api.merchant.geidea.net/payment-intent/api/v2/direct/session
      body:
        type: json
        data: '{"amount": 100.00, "currency": "SAR", "timestamp": "7/12/2026 10:00:00 AM", "merchantReferenceId": "order-0001",
          "callbackUrl": "https://example.com/geidea/callback", "signature": ""}'
    docs: Creates a payment session for the hosted Geidea Checkout page or a Direct API flow. Signed with an HMAC signature.
- info:
    name: Direct API
    type: folder
  items:
  - info:
      name: Initiate Authentication
      type: http
    http:
      method: POST
      url: https://api.merchant.geidea.net/pgw/api/v6/direct/authenticate/initiate
      body:
        type: json
        data: '{"sessionId": "", "cardOnFile": false, "paymentMethod": {}}'
    docs: Starts 3-D Secure authentication for a card within a session.
  - info:
      name: Authenticate Payer
      type: http
    http:
      method: POST
      url: https://api.merchant.geidea.net/pgw/api/v6/direct/authenticate/payer
      body:
        type: json
        data: '{"sessionId": "", "threeDSecureId": ""}'
    docs: Completes 3-D Secure payer authentication and returns a threeDSecureId.
  - info:
      name: Pay
      type: http
    http:
      method: POST
      url: https://api.merchant.geidea.net/pgw/api/v2/direct/pay
      body:
        type: json
        data: '{"sessionId": "", "orderId": "", "threeDSecureId": "", "paymentMethod": {}}'
    docs: Processes a card payment against an authenticated session.
- info:
    name: Transaction Management
    type: folder
  items:
  - info:
      name: Capture Transaction
      type: http
    http:
      method: POST
      url: https://api.merchant.geidea.net/pgw/api/v1/direct/capture
      body:
        type: json
        data: '{"orderId": "", "amount": 100.00, "currency": "SAR", "signature": ""}'
    docs: Captures a previously authorized transaction, in full or in part.
  - info:
      name: Void Payment
      type: http
    http:
      method: POST
      url: https://api.merchant.geidea.net/pgw/api/v3/direct/void
      body:
        type: json
        data: '{"orderId": "", "reason": ""}'
    docs: Voids an authorization that has not yet been captured.
  - info:
      name: Refund - Full or Partial
      type: http
    http:
      method: POST
      url: https://api.merchant.geidea.net/pgw/api/v2/direct/refund
      body:
        type: json
        data: '{"orderId": "", "amount": 100.00, "currency": "SAR", "signature": ""}'
    docs: Refunds a captured/settled transaction in full or in part. Signed with an HMAC signature.
  - info:
      name: Cancel Order
      type: http
    http:
      method: POST
      url: https://api.merchant.geidea.net/pgw/api/v1/direct/cancel
      body:
        type: json
        data: '{"orderId": "", "reason": ""}'
    docs: Cancels an order that has not completed payment.
  - info:
      name: Fetch Transaction or Order
      type: http
    http:
      method: GET
      url: https://api.merchant.geidea.net/pgw/api/v1/direct/order/:orderId
      params:
      - name: orderId
        value: ''
        type: path
        description: The Geidea order id.
    docs: Retrieves the details and status of a transaction or order by id.
- info:
    name: Tokenization
    type: folder
  items:
  - info:
      name: Retrieve Token
      type: http
    http:
      method: GET
      url: https://api.merchant.geidea.net/pgw/api/v1/direct/token/:tokenId
      params:
      - name: tokenId
        value: ''
        type: path
        description: Token id of the stored instrument.
    docs: Retrieves a stored payment instrument (card on file) token by id.

Geidea

APIs

Geidea Checkout API

Geidea Direct API

Geidea Tokenization API

Geidea Transaction Management API

Geidea Pay by Link API

Geidea Pay by Invoice API

Collections

Geidea Payment Gateway API

Pricing Plans

Geidea Plans Pricing

Rate Limits

Geidea Rate Limits

FinOps

Geidea Finops

Resources

Sources