OmanNET for API only
Last updated: March 19, 2025
OmanNET payments follow a two-step process:
You can request a payment using:
- A token
- A payment instrument
- Full card details, if you are SAQ D PCI compliant
All payment requests processed through OmanNET are purchase payments. This means that payments are authorized and captured simultaneously, regardless of the capture value you pass in your request.
If you need to return funds to the cardholder, you must process a full refund instead.
Warning
3D Secure (3DS) is not applicable to payments made through OmanNET. To avoid unexpected declines, you should explicitly set the 3ds.enabled field in your payment request to false.
For the full API specification, see the API reference.
post
https://api.checkout.com/payments
If you receive a 202 Success response with a payment id and a status field set to Pending, your request was successful.
Redirect your customer to the redirect.href link from the response. The subsequent steps vary depending on whether you've enabled OTP for authentication.
If your acquirer MID configuration requires additional authentication, your customer will be prompted for additional information before they can be redirected to the success_url or failure_url. They will be redirected to the OmanNET website and prompted for an OTP code to authorize the payment.
If additional authentication is not required, your customer will be redirected directly to the success_url or failure_url without any further action from your customer required.
Information
Confirmation of an OmanNET payment is only communicated via webhooks. To receive webhooks, configure your webhook server.
Regardless of whether you performed OTP authentication or not, you'll receive a payment_captured webhook when the transaction has completed successfully. Until you receive this webhook, the payment will be labeled as Pending.
Retrieve details about an existing OmanNET payment with the following endpoint:
Information
If you attempt to retrieve details about a payment that is labeled as Pending, you'll receive a 404.
get
https://api.checkout.com/payments/{id}
OmanNET only supports full refunds. You can refund a payment through the Dashboard, or by using our Refund API.
- Create an OmanNET transaction and use the details from one of the test cards.
- Follow the redirect link provided in the response.
- If an OTP is required to complete the payment, enter the code sent to the email address you configured with your account manager. You should then be redirected to your predefined success URL. If an OTP is not required, you will be redirected immediately without an OTP prompt.
| Card number | Card type |
|---|---|
4837915090070004 | OmanNET, co-branded Visa Classic Debit |
4837915090073321 | OmanNET, co-branded Visa Classic Debit |