Skip to main content

Submit Geidea

POST 

/b/checkout/api/sdk/v1/geidea_sdk/submit/:session_id/:pg_code/

This endpoint initializes the Geidea payment flow by provisioning the required SDK configuration for the frontend to launch the appropriate checkout widget. It is used at the beginning of the payment journey to fetch the necessary JS SDK URLs, session ID, merchant public key, and other metadata specific to Geidea. Flow Summary:

  1. Validate Inputs: The pg_code and session_id are validated via the serializer.
  2. Locate Transaction: Retrieves the payment transaction using the session_id.
  3. Setup Context: Resolves the merchant identity and loads configuration.
  4. Provision SDK: Calls the payment gateway's get_vendor_sdk_config() to receive SDK metadata.
  5. Respond: Returns the configuration as a unified structure to be consumed by the frontend. Typical Use Case:
  • Used by the frontend to prepare a Geidea checkout UI.
  • Requires an initial context/token.

Request

Responses