Getting Started
Welcome to Ottu’s API documentation! We have designed our platform to offer a unified API experience across all our endpoints. No matter which payment gateway you choose, you’ll find the same intuitive interface, allowing you to integrate just once and leave the heavy lifting to us. Before diving into the technical details, you should familiarize yourself with a few key concepts that will recur throughout our documentation.
In the context of Ottu, the payment gateway holds the MID (Merchant ID) credentials provided by your bank. For more details on this, check the Payment Gateway section. Currently, our staff handle this configuration and will provide you with the pg_codes needed for the API. Alternatively, you can fetch these codes using our Payment Methods API.
Currency configuration involves setting up the currencies you want to charge your customers. Ottu supports multi-currency transactions. If your MID is set up for KWD, but you want to display the charge amount to your customers in USD, we’ve got you covered. Your customers will see the amount in USD, but the actual funds will arrive in your bank account in KWD. Find more details in our Currency Configuration section.
Every payment or API operation starts with or involves a payment transaction. Essentially, this is the metadata for the payment. It includes information like amount, currency, customer data (email, phone number, address), and more. A payment transaction’s state can change based on the flow created, paid, expired, canceled, etc.). Learn more in the Payment Transaction section.
To get started with Ottu’s REST API, first understand our authentication methods in the Authentication section. Then proceed to the Checkout API section to learn how to create payments and charge customers. Following this, you might want to explore the Payment Notification Webhook. This feature is crucial if you want to integrate Ottu with a system and get notified about payment status updates. After creating a payment transaction, you can specify a webhook URL where Ottu will send updates about the payment status. This will keep your systems up to date in real-time with payment events. See Webhook.
If you're building an ecommerce website or mobile app, Ottu offers a flexible and easy-to-integrate Checkout SDK that wraps the full checkout experience into a simple drop-in solution. The SDK is available for both web and mobile platforms and is designed to work seamlessly with the Checkout API, ensuring you don’t need to handle payment logic manually.
Key features include:
Built-in support for Apple Pay, Google Pay, and other digital wallets, automatically enabled when the SDK is used on compatible devices.
Simplified integration: Load the SDK, initialize it with your transaction session, and let it handle rendering, payment options, and status transitions.
Optimized user experience: The SDK ensures a consistent and smooth flow across devices, helping you reduce development time and increase conversion.
For details on installation and usage, check out the Checkout SDK documentation.
Based on your specific needs, you can proceed to the sections that apply to your business:
You don’t need to perform any additional steps. Just use the Checkout API to create payment links and share them with your customers. They’ll land on Ottu’s checkout page, where we handle everything.
Our Checkout SDK is perfect for you. Available for both web and mobile apps, it integrates seamlessly with the Checkout API. Simply load the library and install it on your page, and it will manage the entire payment process.
These services work only with the Checkout SDK. The SDK automatically enables these services on your website or app without any further configuration.
After familiarizing yourself with the Checkout API, check the Operations section to understand how they work. If you wish to use these operations, the next step is to check the Webhook Operation Notification section.
Check the User Cards and Auto-Debit Docs.
Our sensitive API calls are signed for added security. Check out the Signing Mechanism section.
For any other questions, please feel free to contact your local Ottu representative. Happy integration!
Last updated