Paymob

Getting Started - Egypt

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

Payment Links

Payment Link (Quick Link)

Payment Link (API)

Invoices

Products

Invoice Link Creation (API)

Product Link Creation (API)

Payment Actions

API Level

Dashboard

Transaction Inquiry API- Retrieve A Transaction

Pay With Saved Card Token

Payment Methods

Card

Wallets

Apple Pay

InstaPay (Coming Soon)

Kiosk

Bank Installments

ValU

Souhoola V3

Aman V3

Forsa

Premium

Contact

SYMPL

HALAN

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

Subscriptions

Authentication Request (Generate Token)

Create Subscription plan

Create Subscriptions

Suspend Subscription Plan

Resume Subscription plan

Update Subscription Plan

List Subscription Plans

Suspend Subscription

Resume Subscription

Cancel Subscription

Update Subscription

List Subscription Cards 

Change Subscription Primary card

Delete Secondary Card

List Subscription Details

Transaction ID Subscriptions

Last Transaction Subscription

List Subscription Transactions

Webhook

Bills Portal API 

Home

Payouts

Definitions and Acronyms

Generate and Refresh Token API Endpoint

Instant Cashin API Endpoint

Cancel Aman Transaction API Endpoint

Bulk Transaction Inquiry API Endpoint

User Budget Inquiry API Endpoint

CallBack Url

Response Codes

Frequently Asked Questions (FAQs)

Troubleshooting

Blank

EGYPT-DOCS

End Point

Sandbox

<h3 class="slate-h3 " ><span style="color:#0C5394">Sign up for registering a new account</span></h3><div class="slate-hr"><hr contenteditable="false" class="slate-HrElement-hr"/></div><p class="slate-p " >A guide to registering a new accept account.</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 slate-indent-0" style="0px">Why do I have to?
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://accept.paymob.com/portal2/en/login" 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/bb0e8d47-714f-4af0-85ca-a0803cd58062.jpg" style="
              width:1507px;
	            height:712px;
	            aspect-ratio:1507 / 712"
         /></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/f1469b73-0ba7-4869-bb57-64ca151216bb.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/052e8ca6-8395-48cd-bf23-472943eb4c03.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/36979b91-eabd-4eae-94b1-43037f61ebdd.jpg" style="
              width:1507px;
	            height:717px;
	            aspect-ratio:1507 / 717"
         /></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://accept.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!

<h4>A detailed guide to your Accept dashboard</h4><p>In order to deal with any of Accept's services, you have to create an <a href="https://accept.paymob.com/portal2/en/login" target="_self">Accept account</a>.</p><p>In your Accept portal, you can find:</p><ul><li><div>Profile.</div></li><li><div>Payment Integrations. </div></li></ul>

A detailed guide to your Accept dashboard

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

<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><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> 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 r</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:

<h3 class="slate-h3 " ><strong class="slate-bold">Retrieve A Transaction allows you to obtain the details and status of a transaction-whether it is successful or failed,  using one of the following methods:</strong></h3><ol class="slate-ol " ><li class="slate-li " ><div style="position:relative"><strong class="slate-bold">Retrieve Transaction with Order ID</strong>
Use the Order ID to access transaction details.</div></li><li class="slate-li " ><div style="position:relative"><strong class="slate-bold">Retrieve Transaction with Transaction ID</strong>
Use the Transaction ID to obtain the relevant transaction information.</div></li><li class="slate-li " ><div style="position:relative"><strong class="slate-bold">Retrieve Transaction with Merchant Order ID(Special Reference Number)</strong>
Access transaction details using the Merchant Order ID (Special Reference Number).</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>

Retrieve A Transaction allows you to obtain the details and status of a transaction-whether it is successful or failed,  using one of the following methods:

<h3 class="slate-h3 " ><strong class="slate-bold">Authentication Request API allows you to pass your API key or login details to generate a token in the response.</strong></h3><div class="slate-hr"><hr contenteditable="false" class="slate-HrElement-hr"/></div><p class="slate-p " ><u class="slate-underline"><strong class="slate-bold">Step 1</strong></u><strong class="slate-bold">: Y</strong>ou need to obtain an authentication token through the below auth request using “api_key” or “login” details.</p><p class="slate-p slate-indent-0" style="0px"><strong class="slate-bold">URL: </strong><span style="color:#4B85E8"><u class="slate-underline"><strong class="slate-bold">https://accept.paymob.com/api/auth/tokens</strong></u></span></p><p class="slate-p slate-indent-0" style="0px"><strong class="slate-bold">Method: </strong>POST</p><p class="slate-p " ><strong class="slate-bold">Source</strong>: <em class="slate-italic">Merchant&apos;s server</em></p><p class="slate-p " ><strong class="slate-bold">Recipient</strong>: <em class="slate-italic">Accept&apos;s server</em></p><p class="slate-p " ><span style="color:#1155CB"><u class="slate-underline"><strong class="slate-bold">Step 1.1:</strong></u></span><span style="color:#1155CB"><strong class="slate-bold"> API KEY</strong></span></p><p class="slate-p slate-indent-0" style="0px">You can pass the API key in the parameters to receive the token in the response. For API key details please refer to this s<a href="https://developers.paymob.com/egypt/api-reference-guide/api-setup-secret-and-public-key" target="">ection.</a></p><p class="slate-p " ><strong class="slate-bold">Request:</strong></p><div style="text-align:left"><img src="https://theneo-prod-public.s3.us-east-1.amazonaws.com/9457680e-42ad-48e1-9ee4-3bf9853a680e.jpg" style="
              width:1507px;
	            height:487px;
	            aspect-ratio:1507 / 487"
         /></div><p class="slate-p " ><strong class="slate-bold">Response :</strong></p><div style="text-align:left"><img src="https://theneo-prod-public.s3.us-east-1.amazonaws.com/eb87925c-e8b8-4073-a5a1-e65479e65175.jpg" style="
              width:1507px;
	            height:431px;
	            aspect-ratio:1507 / 431"
         /></div><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 ><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 " >The token has an expiration limit of 60 minutes. After this period, you will need to generate a new token.</p></div></div><p class="slate-p " ><span style="color:#1155CB"><u class="slate-underline"><strong class="slate-bold">Step 1.2:</strong></u></span><span style="color:#1155CB"><strong class="slate-bold"> LOGIN:</strong></span></p><p class="slate-p " >You can pass the login details in the parameters to receive the token in the response. </p><p class="slate-p " ><strong class="slate-bold">Request:</strong></p><div style="text-align:left"><img src="https://theneo-prod-public.s3.us-east-1.amazonaws.com/07c4bf1a-e233-4f76-a75e-fd26605bf597.jpg" style="
              width:1507px;
	            height:472px;
	            aspect-ratio:1507 / 472"
         /></div><p class="slate-p " ><strong class="slate-bold">Response:</strong></p><div style="text-align:left"><img src="https://theneo-prod-public.s3.us-east-1.amazonaws.com/9bbecea1-9be7-4b4f-9e12-61d787df952f.jpg" style="
              width:1507px;
	            height:431px;
	            aspect-ratio:1507 / 431"
         /></div><div class="slate-div"></div><div class="slate-div"></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><p class="slate-p " ></p><p class="slate-p " ></p>

Authentication Request API allows you to pass your API key or login details to generate a token in the response.

ou need to obtain an authentication token through the below auth request using “api_key” or “login” details.

https://accept.paymob.com/api/auth/tokens

You can pass the API key in the parameters to receive the token in the response. For API key details please refer to this s

You can pass the login details in the parameters to receive the token in the response. 

Authentication Request (Generate Token) 

This API Key you will find in your Dashboard settings tab, to authenticate your request.

api_key

profile

You will get a Authentication token in response of the Authentication request and you will need to use this token as "Authentication bearer token" in next subscription APIs

token

<h3 class="slate-h3 " ><strong class="slate-bold">How to get the Order ID?</strong></h3><p class="slate-p " >Answer: You can obtain the Order ID from your dashboard or from the transaction response in a webhook. Please see the screenshots below for both methods.</p><p class="slate-p " ><u class="slate-underline"><strong class="slate-bold">Order ID From Dashboard:</strong></u></p><div style="text-align:left"><img src="https://theneo-prod-public.s3.us-east-1.amazonaws.com/ec52ed91-58a0-41e3-b9da-e5b9e9916697.jpg" style="
              width:1507px;
	            height:639px;
	            aspect-ratio:1507 / 639"
         /></div><p class="slate-p " ><u class="slate-underline"><strong class="slate-bold">Order ID From Transaction Response in Webhook:</strong></u></p><div style="text-align:left"><img src="https://theneo-prod-public.s3.us-east-1.amazonaws.com/cde4237c-3e6e-4bfc-b58f-a41d04554538.jpg" style="
              width:1507px;
	            height:541px;
	            aspect-ratio:1507 / 541"
         /></div><div class="slate-hr"><hr contenteditable="false" class="slate-HrElement-hr"/></div><p class="slate-p " ><u class="slate-underline"><strong class="slate-bold">Step 1:</strong></u> First, you will run an Authentication request to get the Auth Bearer Token for Authorization as explained in the “<a href="https://developers.paymob.com/egypt/payment-actions/retrieve-a-transaction-inquiry-with-order-id-copy-1/authentication-request-generate-token-copy-1" target=""><span style="color:#000000"><strong class="slate-bold">Authentication Request (Generated Token)”</strong></span></a><span style="color:#000000"> </span>section.</p><div class="slate-hr"><hr contenteditable="false" class="slate-HrElement-hr"/></div><p class="slate-p " ><u class="slate-underline"><strong class="slate-bold">Step 2:</strong></u> Please send a POST request to the URL below. Select &quot;Bearer Token&quot; as the authentication type and enter the authentication token in the token box of the authorization section.</p><p class="slate-p slate-indent-0" style="0px"><strong class="slate-bold">URL: </strong><span style="color:#4B85E8"><u class="slate-underline"><strong class="slate-bold">https://accept.paymob.com/api/ecommerce/orders/transaction_inquiry</strong></u></span></p><p class="slate-p " ><strong class="slate-bold">Method</strong>: <em class="slate-italic">POST</em></p><p class="slate-p " ><strong class="slate-bold">Source</strong>: <em class="slate-italic">Merchant&apos;s server</em></p><p class="slate-p " ><strong class="slate-bold">Recipient</strong>: <em class="slate-italic">Accept&apos;s server</em></p><p class="slate-p " ><strong class="slate-bold">Authorization</strong>: <em class="slate-italic">Bearer Token {auth token} You need to enter the authentication token value in the token box, as shown in the image below.</em></p><div style="text-align:left"><img src="https://theneo-prod-public.s3.us-east-1.amazonaws.com/217ee3b0-38f0-4b9a-b8f3-a00e5ddf35aa.jpg" style="
              width:1507px;
	            height:508px;
	            aspect-ratio:1507 / 508"
         /></div><div style="width:100%;
	min-width:100%;" class="callout-widget" data-type=info ><div ><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 " >You can inquire about your transaction by including the <code class="slate-code">order_id</code> in the request parameters.</p></div></div><h4 class="slate-h4 " >Request:</h4><div style="text-align:left"><img src="https://theneo-prod-public.s3.us-east-1.amazonaws.com/9d1de8c3-9d89-4e1d-93c8-d4b32c3465cd.jpg" style="
              width:1507px;
	            height:344px;
	            aspect-ratio:1507 / 344"
         /></div><h4 class="slate-h4 " >Response:</h4><div style="text-align:left"><img src="https://theneo-prod-public.s3.us-east-1.amazonaws.com/b88caeaf-df53-47ef-b2a3-44eed75b5155.jpg" style="
              width:1507px;
	            height:868px;
	            aspect-ratio:1507 / 868"
         /></div><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>

Answer: You can obtain the Order ID from your dashboard or from the transaction response in a webhook. Please see the screenshots below for both methods.

Order ID From Transaction Response in Webhook:

 First, you will run an Authentication request to get the Auth Bearer Token for Authorization as explained in the “

 Please send a POST request to the URL below. Select "Bearer Token" as the authentication type and enter the authentication token in the token box of the authorization section.

https://accept.paymob.com/api/ecommerce/orders/transaction_inquiry

Bearer Token {auth token} You need to enter the authentication token value in the token box, as shown in the image below.

Retrieve Transaction With Order ID

order_id

pending

amount_cents

success

is_auth

is_capture

is_standalone_payment

is_voided

is_refunded

is_3d_secure

integration_id

profile_id

has_parent_transaction

order

created_at

transaction_processed_callback_responses

currency

source_data

api_source

terminal_id

merchant_commission

installment

discount_details

is_void

is_refund

data

is_hidden

payment_key_claims

error_occured

is_live

other_endpoint_reference

refunded_amount_cents

source_id

is_captured

captured_amount

merchant_staff_tag

updated_at

is_settled

bill_balanced

is_bill

owner

parent_transaction

unique_ref

<h3 class="slate-h3 " ><strong class="slate-bold">How to get the Transaction ID?</strong></h3><p class="slate-p " >Answer: You can obtain the Transaction ID from your dashboard or from the transaction response in a webhook. Please see the screenshots below for both methods.</p><p class="slate-p " ><u class="slate-underline"><strong class="slate-bold">Transaction ID From Dashboard:</strong></u></p><div style="text-align:left"><img src="https://theneo-prod-public.s3.us-east-1.amazonaws.com/fefd5725-d178-4670-90e2-ea7b0e1f5a9b.jpg" style="
              width:1507px;
	            height:665px;
	            aspect-ratio:1507 / 665"
         /></div><p class="slate-p " ><u class="slate-underline"><strong class="slate-bold">Transaction ID From Transaction Response in Webhook:</strong></u></p><div style="text-align:left"><img src="https://theneo-prod-public.s3.us-east-1.amazonaws.com/077249b1-f04a-4211-a1b1-44d8bfed1cb6.jpg" style="
              width:1507px;
	            height:540px;
	            aspect-ratio:1507 / 540"
         /></div><div class="slate-hr"><hr contenteditable="false" class="slate-HrElement-hr"/></div><p class="slate-p " ><u class="slate-underline"><strong class="slate-bold">Step 1:</strong></u> First, you will run an Authentication request to get the Auth Bearer Token for Authorization as explained in the “<a href="https://developers.paymob.com/egypt/payment-actions/retrieve-a-transaction-inquiry-with-order-id-copy-1/authentication-request-generate-token-copy-1" target=""><span style="color:#000000"><strong class="slate-bold">Authentication Request (Generated Token)”</strong></span></a><span style="color:#000000"> </span>section.</p><div class="slate-hr"><hr contenteditable="false" class="slate-HrElement-hr"/></div><p class="slate-p " ><u class="slate-underline"><strong class="slate-bold">Step 2:</strong></u> Please send a GET request to the URL below. Select &quot;Bearer Token&quot; as the authentication type and enter the authentication token in the token box of the authorization section.</p><p class="slate-p slate-indent-0" style="0px"><strong class="slate-bold">URL: </strong><span style="color:#4B85E8"><u class="slate-underline"><strong class="slate-bold">https://accept.paymob.com/api/acceptance/transactions/transaction_id</strong></u></span></p><p class="slate-p " ><strong class="slate-bold">Method</strong>: <em class="slate-italic">POST</em></p><p class="slate-p " ><strong class="slate-bold">Source</strong>: <em class="slate-italic">Merchant&apos;s server</em></p><p class="slate-p " ><strong class="slate-bold">Recipient</strong>: <em class="slate-italic">Accept&apos;s server</em></p><p class="slate-p " ><strong class="slate-bold">Authorization</strong>: <em class="slate-italic">Bearer Token {auth token} You need to enter the authentication token value in the token box, as shown in the image below.</em></p><div style="text-align:left"><img src="https://theneo-prod-public.s3.us-east-1.amazonaws.com/dd9b563c-a0fe-4046-b952-5c1f572b884f.jpg" style="
              width:1507px;
	            height:488px;
	            aspect-ratio:1507 / 488"
         /></div><div style="width:100%;
	min-width:100%;" class="callout-widget" data-type=info ><div ><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 " >You can inquire about your transaction by including the <code class="slate-code">transaction_id</code> in the URL provided below. No additional information needs to be passed in the request body. Please refer to the screenshot below for clarification.</p></div></div><h4 class="slate-h4 " ><u class="slate-underline">Request:</u></h4><div style="text-align:left"><img src="https://theneo-prod-public.s3.us-east-1.amazonaws.com/35e0a46f-78f1-4956-af77-17a74b649186.jpg" style="
              width:1507px;
	            height:310px;
	            aspect-ratio:1507 / 310"
         /></div><h4 class="slate-h4 " ><u class="slate-underline">Response:</u></h4><div style="text-align:left"><img src="https://theneo-prod-public.s3.us-east-1.amazonaws.com/e45405ef-3a99-4561-a3f1-baf1336293b4.jpg" style="
              width:1507px;
	            height:875px;
	            aspect-ratio:1507 / 875"
         /></div><p class="slate-p " ></p><p class="slate-p " ></p><p class="slate-p " ></p>

Answer: You can obtain the Transaction ID from your dashboard or from the transaction response in a webhook. Please see the screenshots below for both methods.

Transaction ID From Transaction Response in Webhook:

 Please send a GET request to the URL below. Select "Bearer Token" as the authentication type and enter the authentication token in the token box of the authorization section.

https://accept.paymob.com/api/acceptance/transactions/transaction_id

Retreive Transaction With Transaction ID

<h3 class="slate-h3 " ><strong class="slate-bold">How to get the Special Reference Number and Merchant Order ID?</strong></h3><p class="slate-p " >Answer: You can obtain the Special Reference Number or Merchant Order ID from your dashboard or from the transaction response in a webhook. Please see the screenshots below for both methods.</p><div style="width:100%;
	min-width:100%;" class="callout-widget" data-type=info ><div ><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 " >You will Pass a unique special reference number in this request parameter of intention. Refer to a unique or special identifier or reference associated with a transaction or order. It can be used for tracking or categorizing specific types of transactions and it returns within the transaction callback.</p></div></div><p class="slate-p " ><u class="slate-underline"><strong class="slate-bold">Merchant Order ID From Dashboard:</strong></u></p><div style="text-align:left"><img src="https://theneo-prod-public.s3.us-east-1.amazonaws.com/79ad3b6c-5526-4f37-9f1a-95e33cd27ab5.jpg" style="
              width:1507px;
	            height:573px;
	            aspect-ratio:1507 / 573"
         /></div><p class="slate-p " ><u class="slate-underline"><strong class="slate-bold">Special Reference Number From Transaction Response in Webhook:</strong></u></p><div style="text-align:left"><img src="https://theneo-prod-public.s3.us-east-1.amazonaws.com/ed9f156e-ef3b-4fe8-ad53-b432c61d6817.jpg" style="
              width:1507px;
	            height:344px;
	            aspect-ratio:1507 / 344"
         /></div><div class="slate-hr"><hr contenteditable="false" class="slate-HrElement-hr"/></div><p class="slate-p " ><u class="slate-underline"><strong class="slate-bold">Step 1:</strong></u> First, you will run an Authentication request to get the Auth Bearer Token for Authorization as explained in the “<a href="https://developers.paymob.com/egypt/payment-actions/retrieve-a-transaction-inquiry-with-order-id-copy-1/authentication-request-generate-token-copy-1" target=""><span style="color:#000000"><strong class="slate-bold">Authentication Request (Generated Token)”</strong></span></a><span style="color:#000000"> </span>section.</p><div class="slate-hr"><hr contenteditable="false" class="slate-HrElement-hr"/></div><p class="slate-p " ><u class="slate-underline"><strong class="slate-bold">Step 2:</strong></u> Please send a POST request to the URL below. Select &quot;Bearer Token&quot; as the authentication type and enter the authentication token in the token box of the authorization section.</p><p class="slate-p slate-indent-0" style="0px"><strong class="slate-bold">URL: </strong><span style="color:#4B85E8"><u class="slate-underline"><strong class="slate-bold">https://accept.paymob.com/api/ecommerce/orders/transaction_inquiry</strong></u></span></p><p class="slate-p " ><strong class="slate-bold">Method</strong>: <em class="slate-italic">POST</em></p><p class="slate-p " ><strong class="slate-bold">Source</strong>: <em class="slate-italic">Merchant&apos;s server</em></p><p class="slate-p " ><strong class="slate-bold">Recipient</strong>: <em class="slate-italic">Accept&apos;s server</em></p><p class="slate-p " ><strong class="slate-bold">Authorization</strong>: <em class="slate-italic">Bearer Token {auth token} You need to enter the authentication token value in the token box, as shown in the image below.</em></p><div style="text-align:left"><img src="https://theneo-prod-public.s3.us-east-1.amazonaws.com/217ee3b0-38f0-4b9a-b8f3-a00e5ddf35aa.jpg" style="
              width:1507px;
	            height:508px;
	            aspect-ratio:1507 / 508"
         /></div><div style="width:100%;
	min-width:100%;" class="callout-widget" data-type=info ><div ><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 " >You can inquire about your transaction by passing the merchant_order_id or Special_reference  in the request parameter.</p><p class="slate-p " >You can pass the merchant order ID or the special reference number (used in the intention) in the <code class="slate-code">merchant_order_id </code>parameter.</p></div></div><h4 class="slate-h4 " ><u class="slate-underline">Request:</u></h4><div style="text-align:left"><img src="https://theneo-prod-public.s3.us-east-1.amazonaws.com/e0683ff7-e726-4b0b-bad8-2f3572c7b44a.jpg" style="
              width:1507px;
	            height:360px;
	            aspect-ratio:1507 / 360"
         /></div><h4 class="slate-h4 " ><u class="slate-underline">Response:</u></h4><div style="text-align:left"><img src="https://theneo-prod-public.s3.us-east-1.amazonaws.com/b88caeaf-df53-47ef-b2a3-44eed75b5155.jpg" style="
              width:1507px;
	            height:865px;
	            aspect-ratio:1507 / 865"
         /></div><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>

How to get the Special Reference Number and Merchant Order ID?

Answer: You can obtain the Special Reference Number or Merchant Order ID from your dashboard or from the transaction response in a webhook. Please see the screenshots below for both methods.

Special Reference Number From Transaction Response in Webhook:

Retrieve Transaction With Merchant Order ID (Special Reference Number)

merchant_order_id

<p>Paymob facilitates seamless payments by allowing users to transact with saved card tokens, which enable transactions using previously stored cards. There are two primary methods for utilizing these saved tokens for payments:</p><ul><li><div><strong>Normal Moto Integration Flow</strong></div></li><li><div><strong>Saved Tokens Throu</strong></div></li></ul>

Paymob facilitates seamless payments by allowing users to transact with saved card tokens, which enable transactions using previously stored cards. There are two primary methods for utilizing these saved tokens for payments:

<p>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><p></p><div> <a href="https://drive.google.com/file/d/1QNazSTFpZ3ES2HUZXHNmfI71CG6kzOeB/view?usp=drive_link" target="_blank"></a></div>

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.