Paymob

Getting Started - Oman

Accept Dashboard

Profile

Payment Integrations

Orders

Transactions

Checkout Customization

API Reference Guide

Basics of API

API Setup -(Secret and Public Key)

Checkout 

Intention/Payment API

Test Credentials

Pixel (Native Payment Experience)

Payment Links

Payment Link (Quick Link)

Payment Link (API)

Payment Actions

Dashboard

API Level

Transaction Inquiry API- Retrieve A Transaction

Pay With Saved Card Token

Payment Methods

MIGS Card/ Omannet

Manage Callback

Transaction Callbacks

HMAC Calculation

HMAC Redirection

Error Codes

Risk Declines

Error Messages

E-Commerce Plugins

Shopify

WordPress

WooCommerce

OpenCart

Magento 

WHMCS

Cs-Cart

PrestaShop

Joomla

ZenCart

OsCommerce

Laravel-Bagisto

Drupal

Mobile SDKs

Mobile SDKs V2

Frequently Asked Questions (FAQs)

Troubleshooting 

Blank

OMAN-DOCS

End Point

Sandbox

<h3 class="slate-h3 " ><span style="color:#0C5394">Sign up for registering a new account</span></h3><p class="slate-p slate-indent-0" style="0px">
A guide to registering a new accept account.</p><div class="slate-hr"><hr contenteditable="false" class="slate-HrElement-hr"/></div><div style="width:100%;
	min-width:100%;" class="callout-widget" data-type=info ><div class="callout-icon"><svg width="20" height="20" viewBox="0 0 20 20" fill="none" xmlns="http://www.w3.org/2000/svg"><path d="M10.0628 14.1676C10.2434 14.1676 10.3927 14.1086 10.5107 13.9905C10.6288 13.8725 10.6878 13.7232 10.6878 13.5426V9.77177C10.6878 9.6051 10.6253 9.46274 10.5003 9.34469C10.3753 9.22663 10.2295 9.1676 10.0628 9.1676C9.88227 9.1676 9.73296 9.22663 9.61491 9.34469C9.49685 9.46274 9.43783 9.61205 9.43783 9.7926V13.5634C9.43783 13.7301 9.50033 13.8725 9.62533 13.9905C9.75033 14.1086 9.89616 14.1676 10.0628 14.1676ZM10.0003 7.62594C10.1948 7.62594 10.358 7.56344 10.4899 7.43844C10.6219 7.31344 10.6878 7.15371 10.6878 6.95927C10.6878 6.76482 10.6219 6.59816 10.4899 6.45927C10.358 6.32038 10.1948 6.25094 10.0003 6.25094C9.80588 6.25094 9.64269 6.32038 9.51074 6.45927C9.3788 6.59816 9.31283 6.76482 9.31283 6.95927C9.31283 7.15371 9.3788 7.31344 9.51074 7.43844C9.64269 7.56344 9.80588 7.62594 10.0003 7.62594ZM10.0003 18.3343C8.81977 18.3343 7.72255 18.1225 6.70866 17.6989C5.69477 17.2752 4.81283 16.6884 4.06283 15.9384C3.31283 15.1884 2.72602 14.3065 2.30241 13.2926C1.8788 12.2787 1.66699 11.1815 1.66699 10.0009C1.66699 8.83427 1.8788 7.74399 2.30241 6.7301C2.72602 5.71621 3.31283 4.83427 4.06283 4.08427C4.81283 3.33427 5.69477 2.74399 6.70866 2.31344C7.72255 1.88288 8.81977 1.6676 10.0003 1.6676C11.167 1.6676 12.2573 1.88288 13.2712 2.31344C14.285 2.74399 15.167 3.33427 15.917 4.08427C16.667 4.83427 17.2573 5.71621 17.6878 6.7301C18.1184 7.74399 18.3337 8.83427 18.3337 10.0009C18.3337 11.1815 18.1184 12.2787 17.6878 13.2926C17.2573 14.3065 16.667 15.1884 15.917 15.9384C15.167 16.6884 14.285 17.2752 13.2712 17.6989C12.2573 18.1225 11.167 18.3343 10.0003 18.3343ZM10.0003 17.0843C11.9448 17.0843 13.6114 16.3898 15.0003 15.0009C16.3892 13.612 17.0837 11.9454 17.0837 10.0009C17.0837 8.05649 16.3892 6.38982 15.0003 5.00094C13.6114 3.61205 11.9448 2.9176 10.0003 2.9176C8.05588 2.9176 6.38921 3.61205 5.00033 5.00094C3.61144 6.38982 2.91699 8.05649 2.91699 10.0009C2.91699 11.9454 3.61144 13.612 5.00033 15.0009C6.38921 16.3898 8.05588 17.0843 10.0003 17.0843Z" fill="#3960B4"></path></svg></div><div ><p class="slate-p slate-indent-0" style="0px">Why do I have to?</p><p class="slate-p slate-indent-0" style="0px">In order to deal with any of Accept&apos;s services, you have to register an account, this tutorial will be your guide to create one.</p></div></div><h3 class="slate-h3 " > <span style="color:#0C5394">To create your account, follow these steps</span></h3><ol class="slate-ol " ><li class="slate-li " ><div style="position:relative">Navigate to <a href="https://oman.paymob.com/portal2/en/register" target="_self">Accept&apos;s home page</a></div></li></ol><div style="text-align:left"><img src="https://theneo-prod-public.s3.us-east-1.amazonaws.com/050ef4ff-08ba-4dcd-9a50-8ad1171132c1.jpg" style="
              width:1507px;
	            height:812px;
	            aspect-ratio:1507 / 812"
         /></div><p class="slate-p slate-indent-0" style="0px">2. After that, you will enter your mobile number<span style="color:#000000"> on which you will be receiving OTP for first-time verification.</span></p><div style="text-align:left"><img src="https://theneo-prod-public.s3.us-east-1.amazonaws.com/3570aef6-3b61-40dd-8c59-f1d8350c6759.jpg" style="
              width:1507px;
	            height:707px;
	            aspect-ratio:1507 / 707"
         /></div><p class="slate-p " >3. As soon as you enter the OTP that you have received on your mobile number, you will get the below screen where you will be adding your name, and email details including your desired Password which you will be using for further logging.</p><div style="text-align:left"><img src="https://theneo-prod-public.s3.us-east-1.amazonaws.com/a4e2aa9f-f178-4c0f-a7f9-e946971322bc.jpg" style="
              width:1507px;
	            height:706px;
	            aspect-ratio:1507 / 706"
         /></div><p class="slate-p " >4. Please note that after this screen you will get a login screen where you will be entering your registered mobile number without country code and your password which you have set in the previous screen.</p><div style="text-align:left"><img src="https://theneo-prod-public.s3.amazonaws.com/images-1698998787541.jpg" style="
              width:1507px;
	            height:686px;
	            aspect-ratio:1507 / 686"
         /></div><p class="slate-p " >5. As soon as you will log in, you will get the below screen to enter your business details.</p><div style="text-align:left"><img src="https://theneo-prod-public.s3.amazonaws.com/images-1696860313071.png" style="
              width:620px;
	            height:231px;
	            aspect-ratio:620 / 231"
         /></div><div style="text-align:left"><img src="https://theneo-prod-public.s3.amazonaws.com/images-1696860405736.png" style="
              width:612px;
	            height:336px;
	            aspect-ratio:612 / 336"
         /></div><div style="text-align:left"><img src="https://theneo-prod-public.s3.amazonaws.com/images-1696860450435.png" style="
              width:610px;
	            height:371px;
	            aspect-ratio:610 / 371"
         /></div><p class="slate-p " ></p><p class="slate-p slate-indent-0" style="0px">After filling in this information, you will get a &quot; <span style="color:#0C5394"><strong class="slate-bold">Registration successful</strong></span>&quot; message on the screen and you will be routed to your Paymob Dashboard as below :</p><div style="text-align:left"><img src="https://theneo-prod-public.s3.us-east-1.amazonaws.com/1f0afa8e-24e5-4a5e-ba22-6029ea41f1c2.jpg" style="
              width:1507px;
	            height:585px;
	            aspect-ratio:1507 / 585"
         /></div><p class="slate-p " ><p class="slate-p " >Great-Now you have successfully made your Merchant portal dashboard </p></p><p class="slate-p " >Now you can go to the <a href="https://oman.paymob.com/portal2/en/login" target="_self"><strong class="slate-bold">Sign-In page</strong></a> and start accepting online payments from your customers, Go check our use case guide and choose your perfect payment scenario!</p><div style="width:100%;
	min-width:100%;" class="callout-widget" data-type=info ><div class="callout-icon"><svg width="20" height="20" viewBox="0 0 20 20" fill="none" xmlns="http://www.w3.org/2000/svg"><path d="M10.0628 14.1676C10.2434 14.1676 10.3927 14.1086 10.5107 13.9905C10.6288 13.8725 10.6878 13.7232 10.6878 13.5426V9.77177C10.6878 9.6051 10.6253 9.46274 10.5003 9.34469C10.3753 9.22663 10.2295 9.1676 10.0628 9.1676C9.88227 9.1676 9.73296 9.22663 9.61491 9.34469C9.49685 9.46274 9.43783 9.61205 9.43783 9.7926V13.5634C9.43783 13.7301 9.50033 13.8725 9.62533 13.9905C9.75033 14.1086 9.89616 14.1676 10.0628 14.1676ZM10.0003 7.62594C10.1948 7.62594 10.358 7.56344 10.4899 7.43844C10.6219 7.31344 10.6878 7.15371 10.6878 6.95927C10.6878 6.76482 10.6219 6.59816 10.4899 6.45927C10.358 6.32038 10.1948 6.25094 10.0003 6.25094C9.80588 6.25094 9.64269 6.32038 9.51074 6.45927C9.3788 6.59816 9.31283 6.76482 9.31283 6.95927C9.31283 7.15371 9.3788 7.31344 9.51074 7.43844C9.64269 7.56344 9.80588 7.62594 10.0003 7.62594ZM10.0003 18.3343C8.81977 18.3343 7.72255 18.1225 6.70866 17.6989C5.69477 17.2752 4.81283 16.6884 4.06283 15.9384C3.31283 15.1884 2.72602 14.3065 2.30241 13.2926C1.8788 12.2787 1.66699 11.1815 1.66699 10.0009C1.66699 8.83427 1.8788 7.74399 2.30241 6.7301C2.72602 5.71621 3.31283 4.83427 4.06283 4.08427C4.81283 3.33427 5.69477 2.74399 6.70866 2.31344C7.72255 1.88288 8.81977 1.6676 10.0003 1.6676C11.167 1.6676 12.2573 1.88288 13.2712 2.31344C14.285 2.74399 15.167 3.33427 15.917 4.08427C16.667 4.83427 17.2573 5.71621 17.6878 6.7301C18.1184 7.74399 18.3337 8.83427 18.3337 10.0009C18.3337 11.1815 18.1184 12.2787 17.6878 13.2926C17.2573 14.3065 16.667 15.1884 15.917 15.9384C15.167 16.6884 14.285 17.2752 13.2712 17.6989C12.2573 18.1225 11.167 18.3343 10.0003 18.3343ZM10.0003 17.0843C11.9448 17.0843 13.6114 16.3898 15.0003 15.0009C16.3892 13.612 17.0837 11.9454 17.0837 10.0009C17.0837 8.05649 16.3892 6.38982 15.0003 5.00094C13.6114 3.61205 11.9448 2.9176 10.0003 2.9176C8.05588 2.9176 6.38921 3.61205 5.00033 5.00094C3.61144 6.38982 2.91699 8.05649 2.91699 10.0009C2.91699 11.9454 3.61144 13.612 5.00033 15.0009C6.38921 16.3898 8.05588 17.0843 10.0003 17.0843Z" fill="#3960B4"></path></svg></div><div ><p class="slate-p " ><span style="color:#F1C231">👍</span><span style="color:#1155CB"><strong class="slate-bold">Note!</strong></span></p><p class="slate-p " >The status of the created account will be marked as a <strong class="slate-bold">&quot;Test&quot;</strong> account, this will allow you to test all of Accept&apos;s services. 
When you finish your testing phase, Please contact your Account Manager or Contact Support team through email  <a href="mailto:support@paymob.com" target="_blank">support@paymob.com</a> or you can also raise a ticket through a support widget in your Merchant portal Dashboard to change its status to be <strong class="slate-bold">&quot;Live&quot;</strong>.</p></div></div><p class="slate-p " ></p><p class="slate-p " ></p><p class="slate-p " ></p>


A guide to registering a new accept account.

To create your account, follow these steps

2. After that, you will enter your mobile number

 on which you will be receiving OTP for first-time verification.

3. As soon as you enter the OTP that you have received on your mobile number, you will get the below screen where you will be adding your name, and email details including your desired Password which you will be using for further logging.

4. Please note that after this screen you will get a login screen where you will be entering your registered mobile number without country code and your password which you have set in the previous screen.

5. As soon as you will log in, you will get the below screen to enter your business details.

After filling in this information, you will get a " 

" message on the screen and you will be routed to your Paymob Dashboard as below :

 and start accepting online payments from your customers, Go check our use case guide and choose your perfect payment scenario!

<p class="slate-p slate-indent-0" style="0px">A detailed guide to your Accept dashboard</p><p class="slate-p " >In order to deal with any of Accept&apos;s services, you have to create an <a href="https://oman.paymob.com/portal2/en/register" target="_self">Accept account</a>.</p><p class="slate-p " >In your Accept portal, you can find:</p><ul class="slate-ul " ><li class="slate-li " ><div style="position:relative">Profile.</div></li><li class="slate-li " ><div style="position:relative">Payment Integrations.</div></li><li class="slate-li " ><div style="position:relative">Orders.</div></li><li class="slate-li " ><div style="position:relative">Transactions.</div></li><li class="slate-li " ><div style="position:relative">Checkout Customization</div></li></ul><p class="slate-p " ></p><p class="slate-p " ></p><p class="slate-p " ></p><p class="slate-p " ></p>

A detailed guide to your Accept dashboard

In order to deal with any of Accept's services, you have to create an 

<p class="slate-p " >Paymob&apos;s APIs are built on the REST architecture, providing a structured approach for developers to interact with their services. Let&apos;s delve into the basics of REST APIs, HTTP methods, parameters, and HTTPS status codes within the Paymob ecosystem:</p><p class="slate-p " ></p><p class="slate-p " ></p><p class="slate-p " ></p>

Paymob's APIs are built on the REST architecture, providing a structured approach for developers to interact with their services. Let's delve into the basics of REST APIs, HTTP methods, parameters, and HTTPS status codes within the Paymob ecosystem:

<p class="slate-p " > Paymob's checkout page is expertly designed to deliver a seamless and efficient payment experience for customers. Featuring a user-friendly interface, it allows for easy navigation throughout the transaction process. Merchants can customize the checkout page to align with their brand identity, ensuring a consistent and engaging experience. Additionally, with robust security measures in place, the Paymob checkout page prioritizes user trust and data protection, making it a reliable choice for both merchants and customers alike.</p><h4 class="slate-h4 " ><strong class="slate-bold">This Section Contains:</strong></h4><ol class="slate-ol " ><li class="slate-li " ><div style="position:relative"><strong class="slate-bold">Complete Hosted Experience of Checkout with Intention Payment through API.</strong></div></li><li class="slate-li " ><div style="position:relative"><strong class="slate-bold">Checkout Customization.</strong></div></li><li class="slate-li " ><div style="position:relative"><strong class="slate-bold">Test Credentials.</strong></div></li></ol><div class="slate-hr"><hr contenteditable="false" class="slate-HrElement-hr"/></div><h4 class="slate-h4 " ></h4><p class="slate-p " ></p><p class="slate-p " ></p><p class="slate-p " ></p><p class="slate-p " ></p>

 Paymob's checkout page is expertly designed to deliver a seamless and efficient payment experience for customers. Featuring a user-friendly interface, it allows for easy navigation throughout the transaction process. Merchants can customize the checkout page to align with their brand identity, ensuring a consistent and engaging experience. Additionally, with robust security measures in place, the Paymob checkout page prioritizes user trust and data protection, making it a reliable choice for both merchants and customers alike.

<p class="slate-p " >This section contains the following topics:</p><ol class="slate-ol " ><li class="slate-li " ><div style="position:relative"><strong class="slate-bold">Refund Transaction through the Dashboard.</strong></div></li><li class="slate-li " ><div style="position:relative"><strong class="slate-bold">Refund Transaction through API.</strong></div></li><li class="slate-li " ><div style="position:relative"><strong class="slate-bold">Void Transaction through the Dashboard.</strong></div></li><li class="slate-li " ><div style="position:relative"><strong class="slate-bold">Void Transaction through API.</strong></div></li><li class="slate-li " ><div style="position:relative"><strong class="slate-bold">Auth/Capture Transaction through the Dashboard.</strong></div></li><li class="slate-li " ><div style="position:relative"><strong class="slate-bold">Auth/Capture Transaction through API.</strong></div></li><li class="slate-li " ><div style="position:relative"><strong class="slate-bold">Transaction Inquiry API - Retrieve a Transaction.</strong></div></li><li class="slate-li " ><div style="position:relative"><strong class="slate-bold">Pay with Saved Card Token.</strong></div></li></ol><div class="slate-hr"><hr contenteditable="false" class="slate-HrElement-hr"/></div><p class="slate-p " ></p><p class="slate-p " ></p><p class="slate-p " ></p><p class="slate-p " ></p><p class="slate-p " ></p>

This section contains the following topics:

You can find the Risk error codes and other Acquirer response code descriptions in this section to know more about your declines, and detailed reasons.

<p class="slate-p " >The Frequently Asked Questions (FAQ) section is a comprehensive resource designed to address common inquiries about our services and features. Here, you will find detailed answers to questions regarding payment methods, transaction processes, technical requirements, and security measures. Whether you're a new user seeking guidance or an experienced merchant looking for specific information, this section aims to provide clarity and support. For any additional questions not covered here, please feel free to reach out to our customer support team at <span style="color:#4B85E8"><u class="slate-underline">support@paymob.com</u></span>.</p><div class="slate-hr"><hr contenteditable="false" class="slate-HrElement-hr"/></div><p class="slate-p " ></p><p class="slate-p " ></p><p class="slate-p " ></p><p class="slate-p " ></p>

The Frequently Asked Questions (FAQ) section is a comprehensive resource designed to address common inquiries about our services and features. Here, you will find detailed answers to questions regarding payment methods, transaction processes, technical requirements, and security measures. Whether you're a new user seeking guidance or an experienced merchant looking for specific information, this section aims to provide clarity and support. For any additional questions not covered here, please feel free to reach out to our customer support team at 