Paymob

Getting Started - Egypt

Accept Dashboard

Profile

Payment Integrations

Orders

Transactions

Checkout Customization.

API Checkout Experience

Basics of API

API Setup - (Secret and Public Key)

Unified Intention API Experience

Pixel (Native Payment Experience)

Split Payment Feature

E-Commerce Plugins

Shopify

WordPress (WooCommerce)

OpenCart

Magento 

Odoo 

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

<p class="slate-p " >Paymob provides a comprehensive range of payment options to suit various business needs, enhancing the flexibility and security of online transactions. The following are the four primary payment types supported by Paymob:</p><h3 class="slate-h3 " >1. <strong class="slate-bold">3D Secure (3DS)</strong></h3><p class="slate-p " >3D Secure (3DS) is a security protocol designed to reduce the risk of fraudulent online transactions by adding an additional layer of authentication. When a cardholder makes a purchase online, 3DS prompts the customer to authenticate their identity with the card issuer during the final stage of the checkout process. This step typically involves entering a one-time password (OTP) or biometric verification, depending on the card issuer’s requirements.</p><h3 class="slate-h3 " >2. <strong class="slate-bold">Auth and Capture</strong></h3><p class="slate-p " >The <strong class="slate-bold">Auth and Capture</strong> payment method is a two-step process where the transaction is initially authorized, but the funds are not immediately captured. First, the payment gateway authorizes the transaction by confirming that the customer has sufficient funds available, but the actual transaction amount will be captured later. If the transaction is not captured within 14 days, it will be automatically voided.</p><h3 class="slate-h3 " >3. <strong class="slate-bold">Card Verification</strong></h3><p class="slate-p " >Card Verification Function is a functionality provided by the Network to authenticate a card transaction without actually deducting the transaction amount from the customer’s card.</p><h3 class="slate-h3 " >4. <strong class="slate-bold">Pay with Saved Card Token</strong></h3><p class="slate-p " >The <strong class="slate-bold">Pay with Saved Card Token</strong> method allows customers to store their card details securely for future transactions. Once a customer has completed a transaction, the payment system stores a unique token that represents their payment method. In subsequent transactions, customers can opt to pay using this saved token without having to re-enter their card details, simplifying the checkout process.</p><div class="slate-hr"><hr contenteditable="false" class="slate-HrElement-hr"/></div><p class="slate-p " ></p>

Payment Types

<p class="slate-p " >3D Secure (3DS), also known as payer authentication, is a security system that helps protect online credit and debit card transactions. It adds an extra layer of security to reduce the risk of fraud, keeping both merchants and customers safe from unauthorized payments. Merchants can set up 3D Secure by using a <strong class="slate-bold">3DS integration ID</strong> in the payment request, making the process smoother while ensuring strong protection. The Intention API lets you create a payment request by providing all the necessary information. Make sure to include all the required details to start the payment request correctly. For more information about the <strong class="slate-bold">Unified API Intention Experience</strong>, please check this section.</p><p class="slate-p " ><strong class="slate-bold">Important points:</strong></p><ol class="slate-ol " ><li class="slate-li " ><div style="position:relative">You can create your integration ID from the Payments Integration tab in the Merchant Portal Dashboard. Please note that any integration ID you create from your dashboard will be set to &quot;Test&quot; status by default. For any configuration changes to a Test Integration ID or if you wish to switch it to &quot;LIVE,&quot; please contact your Account Manager or reach out to the Support team via email at support@paymob.com. Alternatively, you can raise a ticket through the support widget in your Merchant Portal Dashboard.</div></li><li class="slate-li " ><div style="position:relative">This feature works in both live and test environments. </div></li></ol><div class="slate-hr"><hr contenteditable="false" class="slate-HrElement-hr"/></div><p class="slate-p " ></p>

3D Secure (3DS)

<p class="slate-p " >An Auth/Capture transaction has two separate steps:</p><div class="slate-hr"><hr contenteditable="false" class="slate-HrElement-hr"/></div><p class="slate-p " ><strong class="slate-bold">Authorization Transaction:</strong> In this step, you hold (or &quot;authorize&quot;) a certain amount on your customer&apos;s card. Make sure to include the Auth and Capture integration ID in the intention request to authorize the payment. The Intention API helps you create a payment request by providing all the necessary information. Make sure to include all steps and details correctly to successfully start the payment request. For more information on the Unified API Intention Experience, please check this section.</p><p class="slate-p " ><strong class="slate-bold">Important points:</strong></p><ol class="slate-ol " ><li class="slate-li " ><div style="position:relative">You can create your integration ID from the Payments Integration tab in the Merchant Portal Dashboard. Please note that any integration ID you create from your dashboard will be set to &quot;Test&quot; status by default. For any configuration changes to a Test Integration ID or if you wish to switch it to &quot;LIVE,&quot; please contact your Account Manager or reach out to the Support team via email at support@paymob.com. Alternatively, you can raise a ticket through the support widget in your Merchant Portal Dashboard.</div></li><li class="slate-li " ><div style="position:relative">This feature works in both live and test environments. </div></li></ol><p class="slate-p " ><strong class="slate-bold">Capture Transaction:</strong> In this step, you capture the authorized amount, or a smaller amount if needed. If the transaction is not captured within 14 days, it will be automatically canceled.</p><div class="slate-hr"><hr contenteditable="false" class="slate-HrElement-hr"/></div><p class="slate-p " ></p>

Auth and Capture

<p class="slate-p slate-indent-0" style="0px"><strong class="slate-bold">Card Verification Function</strong> is a functionality that the Network provides to authenticate a card transaction without deducting the transaction amount from the customer’s card. This will mainly be used by merchants who want to tokenize customer card information. The transaction flow will be exactly the same as it is for a<strong class="slate-bold"> normal 3DS Card Transaction</strong>. A transaction using the card verification function cannot be refunded or voided. However, once the transaction is completed, Paymob will automatically mark it to be voided in the system.&quot;</p><p class="slate-p " ><strong class="slate-bold">Important points:</strong></p><ol class="slate-ol " ><li class="slate-li " ><div style="position:relative">The merchant should request a card verification Integration ID from their account manager. This integration ID can be used for any API payment. </div></li><li class="slate-li " ><div style="position:relative">This feature works in both live and test environments. </div></li><li class="slate-li " ><div style="position:relative">If the customer doesn’t want to charge any amount on their card, they should set the transaction amount to &quot;false&quot; when creating the subscription plan.&quot;</div></li></ol><div class="slate-hr"><hr contenteditable="false" class="slate-HrElement-hr"/></div><p class="slate-p " ></p>

Card Verification

<p class="slate-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 class="slate-ul " ><li class="slate-li " ><div style="position:relative"><strong class="slate-bold">Pay with Saved Card Token (Normal Moto Integration Flow)</strong></div></li><li class="slate-li " ><div style="position:relative"><strong class="slate-bold">Pay with Saved Card Token (3DS Integration Flow ( Unified Checkout)</strong></div></li></ul><div class="slate-hr"><hr contenteditable="false" class="slate-HrElement-hr"/></div><p class="slate-p " ></p>

Pay With Saved Card Token

Payment Links

Payment Link (Quick Link)

Payment Link (API)

Invoices

Products

Invoice Link Creation (API)

Product Link Creation (API)

Payment Actions

API Level

Dashboard

Payment Methods

Card Payments

Digital Wallets

Apple Pay

Bank Installments

Valu

Souhoola V3

Aman V3

Forsa

Contact

Premium

HALAN

SYMPL

Kiosk

InstaPay (Coming Soon)

Test Credentials

Transaction Inquiry API

Authentication Request (Generate Token) 

Retrieve Transaction With Order ID

Retreive Transaction With Transaction ID

Retrieve Transaction With Merchant Order ID (Special Reference Number)

Manage Callback

Transaction Callbacks 

HMAC 

Error Codes

Risk Declines

Error Messages

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:1489px;
	            height:704px;
	            aspect-ratio:1489 / 704"
         /></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:1489px;
	            height:699px;
	            aspect-ratio:1489 / 699"
         /></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:1489px;
	            height:697px;
	            aspect-ratio:1489 / 697"
         /></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:1489px;
	            height:678px;
	            aspect-ratio:1489 / 678"
         /></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:1489px;
	            height:708px;
	            aspect-ratio:1489 / 708"
         /></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>

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 class="slate-h4 " >A detailed guide to your Accept dashboard</h4><p class="slate-p " >In order to deal with any of Accept&apos;s services, you have to create an <a href="https://accept.paymob.com/portal2/en/login" 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>

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 " >Welcome to the API Checkout Experience documentation! In this guide, you will learn how to integrate and set up our API to provide a seamless and unified checkout experience. This includes everything you need to get started with setting up the API, generating your keys, and configuring both the Unified  Intention API Checkout and Pixel Native Payment experiences.</p><p class="slate-p " >We&apos;ll walk you through the basics of the API, including an overview of how it works, step-by-step instructions on how to get your environment set up, and how to use the various endpoints to facilitate secure and efficient transactions.</p><p class="slate-p " ></p>

Welcome to the API Checkout Experience documentation! In this guide, you will learn how to integrate and set up our API to provide a seamless and unified checkout experience. This includes everything you need to get started with setting up the API, generating your keys, and configuring both the Unified  Intention API Checkout and Pixel Native Payment experiences.

We'll walk you through the basics of the API, including an overview of how it works, step-by-step instructions on how to get your environment set up, and how to use the various endpoints to facilitate secure and efficient transactions.

<h2 class="slate-h2 " ><span style="color:#1155CB">Overview</span></h2><p class="slate-p " >Paymob provides a comprehensive subscription module designed to help merchants efficiently manage their subscriptions on a variety of billing cycles, including weekly, bi-weekly, monthly, quarterly, semi-annual, and annual plans. This module is tailored to meet the specific needs of each merchant, enabling them to create, manage, and control their subscriptions independently through our APIs.</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 " >For any guidance or assistance, please reach out to your account manager. Alternatively, you can contact our support team via email at  <a href="mailto:support@paymob.com" target="_blank">support@paymob.com</a>. When reaching out, please include details regarding your subscription, such as your Subscription ID and Transaction ID, to help us assist you more efficiently.</p></div></div><div class="slate-hr"><hr contenteditable="false" class="slate-HrElement-hr"/></div><h2 class="slate-h2 " ><span style="color:#1155CB">Integration Requirements</span></h2><p class="slate-p " >To successfully set up your subscription plan, you will need two integration IDs:</p><ul class="slate-ul " ><li class="slate-li " ><div style="position:relative"><strong class="slate-bold">Online 3DS Integration ID:</strong> This ID will be used for creating subscriptions.</div></li><li class="slate-li " ><div style="position:relative"><strong class="slate-bold">Moto Integration ID:</strong> Utilize this ID when creating the subscription plan itself.</div></li></ul><p class="slate-p " >Ensure you have both integration IDs ready to streamline the setup process.</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 " >If you wish to verify the card user details (provide a free trial for X days period) instead of deducting the amount while creating the subscription then you can ask our support team at <a href="mailto:support@paymob.com" target="_blank">support@paymob.com</a> to create a 3DS verification integration ID. Noting this amount will be an auto reversal and you need to set the  <span style="color:rgb(182, 66, 76)">&quot;use_transaction_amount&quot;</span>: <span style="color:rgb(30, 83, 163)"><strong class="slate-bold">false</strong></span>  to avoid any override with the Subscription plan amount</p></div></div><p class="slate-p " >For further assistance or detailed API guidance, please refer to the subsequent sections of this documentation.</p><div style="width:100%;
	min-width:100%;" class="callout-widget" data-type=success ><div class="callout-icon"><svg width="18" height="18" viewBox="0 0 18 18" fill="none" xmlns="http://www.w3.org/2000/svg"><path d="M7.77116 10.8968L5.72949 8.8551C5.60449 8.7301 5.45171 8.6676 5.27116 8.6676C5.0906 8.6676 4.93088 8.73705 4.79199 8.87594C4.6531 9.01482 4.58366 9.17455 4.58366 9.3551C4.58366 9.53566 4.6531 9.68844 4.79199 9.81344L7.33366 12.3551C7.45866 12.4801 7.60449 12.5426 7.77116 12.5426C7.93783 12.5426 8.08366 12.4801 8.20866 12.3551L13.2087 7.3551C13.3337 7.2301 13.3927 7.07732 13.3857 6.89677C13.3788 6.71621 13.3128 6.56344 13.1878 6.43844C13.0628 6.29955 12.9066 6.2301 12.7191 6.2301C12.5316 6.2301 12.3684 6.29955 12.2295 6.43844L7.77116 10.8968ZM9.00033 17.3343C7.81977 17.3343 6.72255 17.1225 5.70866 16.6989C4.69477 16.2752 3.81283 15.6884 3.06283 14.9384C2.31283 14.1884 1.72602 13.3065 1.30241 12.2926C0.878798 11.2787 0.666992 10.1815 0.666992 9.00094C0.666992 7.83427 0.878798 6.74399 1.30241 5.7301C1.72602 4.71621 2.31283 3.83427 3.06283 3.08427C3.81283 2.33427 4.69477 1.74399 5.70866 1.31344C6.72255 0.88288 7.81977 0.667603 9.00033 0.667603C10.167 0.667603 11.2573 0.88288 12.2712 1.31344C13.285 1.74399 14.167 2.33427 14.917 3.08427C15.667 3.83427 16.2573 4.71621 16.6878 5.7301C17.1184 6.74399 17.3337 7.83427 17.3337 9.00094C17.3337 10.1815 17.1184 11.2787 16.6878 12.2926C16.2573 13.3065 15.667 14.1884 14.917 14.9384C14.167 15.6884 13.285 16.2752 12.2712 16.6989C11.2573 17.1225 10.167 17.3343 9.00033 17.3343ZM9.00033 16.0843C11.0142 16.0843 12.6982 15.4072 14.0524 14.053C15.4066 12.6989 16.0837 11.0148 16.0837 9.00094C16.0837 6.98705 15.4066 5.30302 14.0524 3.94885C12.6982 2.59469 11.0142 1.9176 9.00033 1.9176C6.98644 1.9176 5.30241 2.59469 3.94824 3.94885C2.59408 5.30302 1.91699 6.98705 1.91699 9.00094C1.91699 11.0148 2.59408 12.6989 3.94824 14.053C5.30241 15.4072 6.98644 16.0843 9.00033 16.0843Z" fill="#06837A"></path></svg></div><div ><p class="slate-p " >Download the <a href="https://drive.google.com/file/d/17_jNJz3QluuuRBlYIyaRUlqcty-A-7xM/view?usp=drive_link" target="">Subscription Module APIs.</a></p></div></div><p class="slate-p " ></p><p class="slate-p " ></p><p class="slate-p " ></p><p class="slate-p " ></p>

Paymob provides a comprehensive subscription module designed to help merchants efficiently manage their subscriptions on a variety of billing cycles, including weekly, bi-weekly, monthly, quarterly, semi-annual, and annual plans. This module is tailored to meet the specific needs of each merchant, enabling them to create, manage, and control their subscriptions independently through our APIs.

To successfully set up your subscription plan, you will need two integration IDs:

Ensure you have both integration IDs ready to streamline the setup process.

For further assistance or detailed API guidance, please refer to the subsequent sections of this documentation.

<p class="slate-p " >Paymob provides a comprehensive range of payment options to suit various business needs, enhancing the flexibility and security of online transactions. The following are the four primary payment types supported by Paymob:</p><h3 class="slate-h3 " ><strong class="slate-bold">1. 3D Secure (3DS)</strong></h3><p class="slate-p " >3D Secure (3DS) is a security protocol designed to reduce the risk of fraudulent online transactions by adding an additional layer of authentication. When a cardholder makes a purchase online, 3DS prompts the customer to authenticate their identity with the card issuer during the final stage of the checkout process. This step typically involves entering a one-time password (OTP) or biometric verification, depending on the card issuer’s requirements.</p><h3 class="slate-h3 " >2. <strong class="slate-bold">Auth and Capture</strong></h3><p class="slate-p " >The <strong class="slate-bold">Auth and Capture</strong> payment method is a two-step process where the transaction is initially authorized, but the funds are not immediately captured. First, the payment gateway authorizes the transaction by confirming that the customer has sufficient funds available, but the actual transaction amount will be captured later. If the transaction is not captured within 07 days, it will be automatically voided.</p><h3 class="slate-h3 " >3. <strong class="slate-bold">Card Verification</strong></h3><p class="slate-p " >Card Verification Function is a functionality provided by the Network to authenticate a card transaction without actually deducting the transaction amount from the customer’s card.</p><h3 class="slate-h3 " >4. <strong class="slate-bold">Pay with Saved Card Token</strong></h3><p class="slate-p " >The <strong class="slate-bold">Pay with Saved Card Token</strong> method allows customers to store their card details securely for future transactions. Once a customer has completed a transaction, the payment system stores a unique token that represents their payment method. In subsequent transactions, customers can opt to pay using this saved token without having to re-enter their card details, simplifying the checkout process.</p><div class="slate-hr"><hr contenteditable="false" class="slate-HrElement-hr"/></div><p class="slate-p " ></p><p class="slate-p " ></p>

Paymob provides a comprehensive range of payment options to suit various business needs, enhancing the flexibility and security of online transactions. The following are the four primary payment types supported by Paymob:

3D Secure (3DS) is a security protocol designed to reduce the risk of fraudulent online transactions by adding an additional layer of authentication. When a cardholder makes a purchase online, 3DS prompts the customer to authenticate their identity with the card issuer during the final stage of the checkout process. This step typically involves entering a one-time password (OTP) or biometric verification, depending on the card issuer’s requirements.

 payment method is a two-step process where the transaction is initially authorized, but the funds are not immediately captured. First, the payment gateway authorizes the transaction by confirming that the customer has sufficient funds available, but the actual transaction amount will be captured later. If the transaction is not captured within 07 days, it will be automatically voided.

Card Verification Function is a functionality provided by the Network to authenticate a card transaction without actually deducting the transaction amount from the customer’s card.

 method allows customers to store their card details securely for future transactions. Once a customer has completed a transaction, the payment system stores a unique token that represents their payment method. In subsequent transactions, customers can opt to pay using this saved token without having to re-enter their card details, simplifying the checkout process.

<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></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><p class="slate-p " ></p>

This section contains the following topics:

<p class="slate-p " ><p class="slate-p " >Paymob provides a wide range of payment methods in Egypt, enabling businesses to offer seamless and secure transactions for their customers. Whether through cards, digital wallets, or installment plans, Paymob ensures a smooth payment experience tailored to diverse customer needs. Below is a list of supported payment methods:</p><ul class="slate-ul " ><li class="slate-li " ><div style="position:relative"><strong class="slate-bold">Card Payments</strong></div></li><li class="slate-li " ><div style="position:relative"><strong class="slate-bold">Digital Wallets</strong></div></li><li class="slate-li " ><div style="position:relative"><strong class="slate-bold">Apple Pay</strong></div></li><li class="slate-li " ><div style="position:relative"><strong class="slate-bold">ValU</strong></div></li><li class="slate-li " ><div style="position:relative"><strong class="slate-bold">Bank Installments</strong></div></li><li class="slate-li " ><div style="position:relative"><strong class="slate-bold">Souhoola V3</strong></div></li><li class="slate-li " ><div style="position:relative"><strong class="slate-bold">Aman V3</strong></div></li><li class="slate-li " ><div style="position:relative"><strong class="slate-bold">Forsa</strong></div></li><li class="slate-li " ><div style="position:relative"><strong class="slate-bold">Premium</strong></div></li><li class="slate-li " ><div style="position:relative"><strong class="slate-bold">Contact</strong></div></li><li class="slate-li " ><div style="position:relative"><strong class="slate-bold">HALAN</strong></div></li><li class="slate-li " ><div style="position:relative"><strong class="slate-bold">SYMPL</strong></div></li><li class="slate-li " ><div style="position:relative"><strong class="slate-bold">Kiosk </strong></div></li><li class="slate-li " ><div style="position:relative"><strong class="slate-bold">InstaPay (Coming Soon)</strong></div></li></ul><p class="slate-p " >This extensive payment network allows businesses to expand their customer reach and simplify transactions through flexible and accessible solutions.</p></p><p class="slate-p " ></p><p class="slate-p " ></p>

<h4 class="slate-h4 " >Here are the test credentials for the online card payment method:</h4><p class="slate-p slate-indent-0" style="0px">Mastercard:</p><div class="table-container" style="width:60%;
  min-width:60%;"><table class="slate-table" style="min-width:100%"><div class="published-table-header" style="width:100%;min-width:100%;min-height:initial;visibility: hidden;border:initial"><div style="width:100px;">Title</div><div style="width:100px;">Description</div></div><colgroup ><col style="width:initial"><col style="width:initial"></colgroup><tbody class="slate-TableElement-tbody"><tr class="slate-tr " ><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p slate-indent-0" style="0px">Card</p></td></div><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p slate-indent-0" style="0px">Mastercard</p></td></div></tr><tr class="slate-tr " ><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p slate-indent-0" style="0px">Card number</p></td></div><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p slate-indent-0" style="0px">5123456789012346</p></td></div></tr><tr class="slate-tr " ><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p slate-indent-0" style="0px">Cardholder Name</p></td></div><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p slate-indent-0" style="0px">Test Account</p></td></div></tr><tr class="slate-tr " ><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p slate-indent-0" style="0px">Expiry Month</p></td></div><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p slate-indent-0" style="0px">12</p></td></div></tr><tr class="slate-tr " ><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p slate-indent-0" style="0px">Expiry Year</p></td></div><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p slate-indent-0" style="0px">25</p></td></div></tr><tr class="slate-tr " ><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p slate-indent-0" style="0px">CVV</p></td></div><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p slate-indent-0" style="0px">123</p></td></div></tr></tbody></table></div><div class="slate-hr"><hr contenteditable="false" class="slate-HrElement-hr"/></div><h3 class="slate-h3 " ><strong class="slate-bold">Wallet Test Credentials :</strong></h3><p class="slate-p " >Here are the test credentials for Wallets;</p><div class="table-container" style="width:100%;min-width:100%"><table class="slate-table" style="min-width:100%"><div class="published-table-header" style="width:100%;min-width:100%;min-height:initial;visibility: hidden;border:initial"><div style="width:100px;">Title</div><div style="width:100px;">Description</div></div><colgroup ><col style="width:initial"><col style="width:initial"></colgroup><tbody class="slate-TableElement-tbody"><tr class="slate-tr " ><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " ><strong class="slate-bold">Wallet Number</strong></p></td></div><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >01010101010</p></td></div></tr><tr class="slate-tr " ><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " ><strong class="slate-bold">MPin Code</strong></p></td></div><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >123456</p></td></div></tr><tr class="slate-tr " ><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " ><strong class="slate-bold">OTP</strong></p></td></div><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >123456</p></td></div></tr></tbody></table></div><h4 class="slate-h4 " ><u class="slate-underline"><strong class="slate-bold">MasterCard For Simulation:</strong></u></h4><div class="table-container" style="width:60%;
  min-width:60%;"><table class="slate-table" style="min-width:100%"><div class="published-table-header" style="width:100%;min-width:100%;min-height:initial;visibility: hidden;border:initial"><div style="width:100px;">Title</div><div style="width:100px;">Description</div></div><colgroup ><col style="width:initial"><col style="width:initial"></colgroup><tbody class="slate-TableElement-tbody"><tr class="slate-tr " ><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >Card</p></td></div><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >Mastercard</p></td></div></tr><tr class="slate-tr " ><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >Card number</p></td></div><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >5123450000000008</p></td></div></tr><tr class="slate-tr " ><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >Cardholder Name</p></td></div><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >TEST CARD</p></td></div></tr><tr class="slate-tr " ><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >Expiry Month</p></td></div><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >01</p></td></div></tr><tr class="slate-tr " ><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >Expiry Year</p></td></div><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >39</p></td></div></tr><tr class="slate-tr " ><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >CVV</p></td></div><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >123</p></td></div></tr></tbody></table></div><p class="slate-p " ><span style="background-color:rgb(255, 255, 255);color:rgb(22, 22, 22)"><u class="slate-underline"><strong class="slate-bold">VISA Card for Simulation:</strong></u></span></p><div class="table-container" style="width:60%;
  min-width:60%;"><table class="slate-table" style="min-width:100%"><div class="published-table-header" style="width:100%;min-width:100%;min-height:initial;visibility: hidden;border:initial"><div style="width:100px;">Title</div><div style="width:100px;">Description</div></div><colgroup ><col style="width:initial"><col style="width:initial"></colgroup><tbody class="slate-TableElement-tbody"><tr class="slate-tr " ><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p slate-indent-0" style="0px">Card</p></td></div><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p slate-indent-0" style="0px">VISA</p></td></div></tr><tr class="slate-tr " ><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p slate-indent-0" style="0px">Card number</p></td></div><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p slate-indent-0" style="0px">4111111111111111</p></td></div></tr><tr class="slate-tr " ><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p slate-indent-0" style="0px">Cardholder Name</p></td></div><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p slate-indent-0" style="0px">Test Account</p></td></div></tr><tr class="slate-tr " ><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p slate-indent-0" style="0px">Expiry Month</p></td></div><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p slate-indent-0" style="0px">12</p></td></div></tr><tr class="slate-tr " ><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p slate-indent-0" style="0px">Expiry Year</p></td></div><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p slate-indent-0" style="0px">25</p></td></div></tr><tr class="slate-tr " ><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p slate-indent-0" style="0px">CVV</p></td></div><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p slate-indent-0" style="0px">123</p></td></div></tr></tbody></table></div><p class="slate-p " ></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 " ><strong class="slate-bold">You will simulate both successful and all failed cases outlined below using the VISA card credentials provided above.</strong></p></div></div><div style="text-align:left"><img src="https://theneo-prod-public.s3.us-east-1.amazonaws.com/abaf33b0-7d69-4b9d-a258-48e21803a217.jpg" style="
              width:1489px;
	            height:992px;
	            aspect-ratio:1489 / 992"
         /></div><h4 class="slate-h4 " ><strong class="slate-bold">Successful Response:</strong>
</h4><div style="text-align:left"><img src="https://theneo-prod-public.s3.us-east-1.amazonaws.com/eeaf0e60-6198-41b8-9999-4f1e7cd53952.jpg" style="
              width:1489px;
	            height:567px;
	            aspect-ratio:1489 / 567"
         /></div><p class="slate-p " ><strong class="slate-bold">Failed Response:</strong></p><div style="text-align:left"><img src="https://theneo-prod-public.s3.us-east-1.amazonaws.com/3a3c82a8-a6b0-4b2d-9ade-88b48cf28746.jpg" style="
              width:1489px;
	            height:581px;
	            aspect-ratio:1489 / 581"
         /></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><p class="slate-p " ></p>

Here are the test credentials for the online card payment method:

Title

Description

Here are the test credentials for Wallets;

<p class="slate-p slate-indent-0" style="0px"><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></p><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><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:

<p class="slate-p " >Welcome to the Manage Callback documentation! In this section, we&apos;ll guide you through the different types of transaction callbacks that are essential for handling payment processing and ensuring a seamless integration with your system. Specifically, we&apos;ll cover transaction processed callbacks, transaction response callbacks, and how to calculate HMAC for processed callbacks, redirection callbacks, and saved card token objects.</p><p class="slate-p " >You will learn how to configure and manage these callbacks, understand their role in transaction flow, and ensure that your system securely processes and responds to different events during payment transactions. Whether you&apos;re dealing with successful payments, handling failures, or managing tokenized card data, this guide will provide you with the necessary tools and knowledge to handle callbacks efficiently and securely.</p><p class="slate-p " >Let&apos;s dive into understanding each callback type and how to calculate and implement HMAC to ensure the integrity and security of your transactions.</p><p class="slate-p " ></p><p class="slate-p " ></p><p class="slate-p " ></p><p class="slate-p " ></p>

Welcome to the Manage Callback documentation! In this section, we'll guide you through the different types of transaction callbacks that are essential for handling payment processing and ensuring a seamless integration with your system. Specifically, we'll cover transaction processed callbacks, transaction response callbacks, and how to calculate HMAC for processed callbacks, redirection callbacks, and saved card token objects.

You will learn how to configure and manage these callbacks, understand their role in transaction flow, and ensure that your system securely processes and responds to different events during payment transactions. Whether you're dealing with successful payments, handling failures, or managing tokenized card data, this guide will provide you with the necessary tools and knowledge to handle callbacks efficiently and securely.

Let's dive into understanding each callback type and how to calculate and implement HMAC to ensure the integrity and security of your transactions.

<p class="slate-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 class="slate-p " ></p><div style="text-align:left"><a href="https://drive.google.com/file/d/1QNazSTFpZ3ES2HUZXHNmfI71CG6kzOeB/view?usp=drive_link" target="_blank" rel="noreferrer"><img src="https://drive.google.com/file/d/1QNazSTFpZ3ES2HUZXHNmfI71CG6kzOeB/view?usp=drive_link" style="width:auto;height:auto" /></a></div><p class="slate-p " ></p><p class="slate-p " ></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 class="slate-p slate-indent-0" style="0px">Paymob has its own Fraud management system to protect its Merchants from Fraudulent Transactions.</p><div class="table-container" style="width:100%;min-width:100%"><table class="slate-table" ><div class="published-table-header" style="width:100%;min-width:100%;"><div style="width:193px;">CODE</div><div style="width:293px;">RESPONSE CODE</div><div style="width:0px;">RESPONSE CODE DESCRIPTION</div></div><colgroup ><col style="width:193px"><col style="width:293px"><col style="width:initial"></colgroup><tbody class="slate-TableElement-tbody"><tr class="slate-tr " ><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >111</p></td></div><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >ip country not in whitelist</p></td></div><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >You will receive 111 Risk decline if you are performing a transaction from Country IP which is not in whitelist. Kindly coordinate with Paymob support team for any further clarity.</p></td></div></tr><tr class="slate-tr " ><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >112</p></td></div><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >ip country in black list</p></td></div><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >You will receive 112 Risk decline if you are performing a transaction from Country IP which is in Blacklist. Kindly coordinate with Paymob support team for any further clarity.</p></td></div></tr><tr class="slate-tr " ><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >113</p></td></div><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >ip not in whitelist</p></td></div><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >You will receive 113 Risk decline if you are performing a transaction from &quot;IP&quot; which is not in Whitelist. Kindly coordinate with Paymob support team for any further clarity.</p></td></div></tr><tr class="slate-tr " ><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >114</p></td></div><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >ip in blacklist</p></td></div><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >you will receive 113 Risk decline if you are performing a transaction from &quot;IP&quot; which is in Blacklist. Kindly coordinate with Paymob support team for any further clarity.</p></td></div></tr><tr class="slate-tr " ><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >121</p></td></div><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >bin country not in whitelist</p></td></div><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >This means that you are performing a transaction from the bank card number , which bin country is not in White list in our FMS (Fraud Management System)</p></td></div></tr><tr class="slate-tr " ><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >122</p></td></div><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >bin country in whitelist</p></td></div><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >This means that you are performing a transaction from the bank card number , which bin country is in black list in our FMS (Fraud Management System)</p></td></div></tr><tr class="slate-tr " ><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >123</p></td></div><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >bin not in whitelist</p></td></div><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >This means that you are performing a transaction from the bank card number , which bin country is in black list in our FMS (Fraud Management System)</p></td></div></tr><tr class="slate-tr " ><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >124</p></td></div><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >bin in blacklist</p></td></div><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >This transacton is getting declined due to Bin is not in whitelist.</p></td></div></tr><tr class="slate-tr " ><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >131</p></td></div><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >amount_cents exceeds allowed</p></td></div><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >This transaction is getting declined due to amount limit exceed.</p></td></div></tr><tr class="slate-tr " ><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >141</p></td></div><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >amount_cents exceeds moto limit</p></td></div><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >This transaction is getting declined due to amount limit exceed.</p></td></div></tr><tr class="slate-tr " ><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >153</p></td></div><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >email dns check failed</p></td></div><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >This means that the email server could not find the DNS record for the entered email address in the invoice. This can happen for a number of reasons, such as: The recipient&apos;s email address is incorrect or contains a typo.</p></td></div></tr><tr class="slate-tr " ><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >154</p></td></div><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >email is disposable</p></td></div><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >&quot;This is due to disposable email addresses often being associated with fraudulent activity. For example, scammers may use disposable email addresses to create fake accounts or to sign up for services without paying.
We may reject payments from disposable email addresses because they are difficult to verify. When making an online payment, we typically needs to verify your identity and your email address. This is to help prevent fraud and to the user financial information.&quot;</p></td></div></tr><tr class="slate-tr " ><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >201</p></td></div><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >IP is in Global Blacklist</p></td></div><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >&quot;IP address is in a global blacklist, it means that that the IP address has been flagged as a potential source of malicious activity. This can happen for a number of reasons, such as:
IP address has been used to send spam or phishing emails.
IP address has been used to launch DDoS attacks.
IP address has been infected with malware.
IP address has been used to commit other types of cybercrime.&quot;</p></td></div></tr><tr class="slate-tr " ><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >202</p></td></div><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >Email in Global Blacklist</p></td></div><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >This is due having the email addresses linked to the attempted transactions identified as being associated with spam, phishing, Fraudulent attempts or other malicious activities. You will need to reach out to Pyamob support team directly for further support and help.</p></td></div></tr><tr class="slate-tr " ><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >301</p></td></div><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >Fraud Engine</p></td></div><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >This means that this transaction has been declined due to Risk Checks and our FMS System has rejected this transaction due to any Fraud management reasons like you are not passing the genuine or unique data i.e Email, phone or Name. To avoid this error please always try to pass genuine customer data in the request parameters.</p></td></div></tr><tr class="slate-tr " ><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >200</p></td></div><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >if merchant is live and using test credentials</p></td></div><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >This error code means that  you are trying to pass test credentials upon live integration ids.</p></td></div></tr></tbody></table></div><p class="slate-p slate-indent-0" style="0px">As for any further inquiries related to the previously mentioned error codes or any codes raised from your side while performing any transaction, 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.</p>

Paymob has its own Fraud management system to protect its Merchants from Fraudulent Transactions.

CODE

RESPONSE CODE

RESPONSE CODE DESCRIPTION

As for any further inquiries related to the previously mentioned error codes or any codes raised from your side while performing any transaction, please contact your Account Manager or Contact Support team through email  

 or you can also raise a ticket through a support widget in your Merchant portal Dashboard.

<p class="slate-p slate-indent-0" style="0px">Error Messages</p><p class="slate-p slate-indent-0" style="0px">If an error occurs during performing a transaction, you can identify the specific error message and code associated with it. These error messages and codes are designed to help you understand what went wrong and how to fix it. By referencing the error message and code, you can gain a clear understanding of the issue and take appropriate action to resolve it. It&apos;s important to review the error message and code carefully to ensure that you address the root cause of the error. By doing so, you can improve the reliability and accuracy of your transactions.</p><div class="table-container" style="width:100%;min-width:100%"><table class="slate-table" ><div class="published-table-header" style="width:100%;min-width:100%;"><div style="width:150px;">CODE</div><div style="width:261px;">RESPONSE</div><div style="width:833px;">DESCRIPTION</div></div><colgroup ><col style="width:150px"><col style="width:261px"><col style="width:833px"></colgroup><tbody class="slate-TableElement-tbody"><tr class="slate-tr " ><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >0</p></td></div><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >Transaction approved</p></td></div><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >The transaction has been processed successfully</p></td></div></tr><tr class="slate-tr " ><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >1</p></td></div><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >Refer to issuer</p></td></div><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >The Cardholder issuer has indicated there is a problem with the credentials/card number used in the transaction. The Cardholder should use an alternate Card/payment method, or contact their bank to resolve this issue.</p></td></div></tr><tr class="slate-tr " ><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >2</p></td></div><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >Refer to issuer, special</p></td></div><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >The Cardholders issuer has indicated there is a problem with the card number. The Cardholder should use an alternate payment method, or contact their bank.</p></td></div></tr><tr class="slate-tr " ><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >3</p></td></div><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >Invalid merchant or service provider</p></td></div><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >This error indicates that either the Merchant facility is non-functional or the details entered into the Gateway are invalid.Reasons for an Invalid Merchant ID Error Code. The disconnection between your merchant account and payment gateway may be caused by a bad gateway configuration, bank error, improper card configuration, or terminated merchant account.  Please reach out to our Customer support for any further support in this regard.</p></td></div></tr><tr class="slate-tr " ><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >4</p></td></div><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >Pick up card</p></td></div><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >The issuing bank of the customer has declined the transaction as the card may have been reported as stolen or lost. Please advise cardholder to contact their issuing bank for the resolution of this error.</p></td></div></tr><tr class="slate-tr " ><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >5</p></td></div><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >Do not honour</p></td></div><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >&quot;Do not error comes when the customer&apos;s issuing bank is not authorising this transaction due to any valid reason.
The payment has been declined by your bank. Please try a different card or contact your bank for further support.
This error can be triggered due to following reason.
a) The bank&apos;s fraud rules (which consider various factors that are not made public) have been triggered.
b) The bank may have placed a temporary hold on the customer&apos;s card.
c) The purchase session may have been locked due to multiple declined payments.
d) The seller is located in a country different from that of the card issuing bank.</p><p class="slate-p " >This can be resolved by following below steps:</p><ol class="slate-ol " ><li class="slate-li " ><div style="position:relative">Ask the customer to contact their bank, explaining that they are trying to process a payment. The customer can ask the bank to allow the payment.
2)Ask the customer to try again at a later time. The issuing bank may have only placed a temporary hold on the card.</div></li><li class="slate-li " ><div style="position:relative">Ask the customer to use an alternative credit card.</div></li></ol><p class="slate-p " >&quot;</p></td></div></tr><tr class="slate-tr " ><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >6</p></td></div><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >Error</p></td></div><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >The Cardholders issuer has declined the transaction as there is a problem with the card number. The Cardholder should contact their card issuer and/or use an alternate payment method.</p></td></div></tr><tr class="slate-tr " ><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >7</p></td></div><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >Pickup card, special condition (other than lost/stolen card)</p></td></div><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >The Cardholders card issuer has declined the transaction and requested that the card be retained as the card may have been reported as lost or stolen.</p></td></div></tr><tr class="slate-tr " ><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >8</p></td></div><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >Honour with identification</p></td></div><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >Transaction processed successfully - identification NOT required. This code is returned by some banks in place of 00 response. This means your transaction has been approved.</p></td></div></tr><tr class="slate-tr " ><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >9</p></td></div><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >Request in progress</p></td></div><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >The Cardholders issuer has indicated there is a problem with the card number. The Cardholder should contact their bank and/or use an alternate payment method.</p></td></div></tr><tr class="slate-tr " ><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >10</p></td></div><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >Approved for partial amount</p></td></div><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >The transaction was successful for a partial amount.</p></td></div></tr><tr class="slate-tr " ><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >12</p></td></div><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >Invalid transaction</p></td></div><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >The bank has declined the transaction because of an invalid format or field. This indicates the card details were incorrect. Check card data entered and try again.                          This code is often returned from the issuer when they do not accept the transaction. This can possibly be when a transaction for the same amount and merchant is attempted multiple times quickly for the same card. The cardholder should contact their issuing bank.</p></td></div></tr><tr class="slate-tr " ><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >13</p></td></div><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >Invalid amount</p></td></div><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >The Cardholders issuer has declined the transaction because of an invalid format or field; or amount exceeds maximum for card program.This usually is the result of a typo (negative amount or ineligible symbol). Double-check what you entered and make sure it wasn&apos;t negative or included incorrect symbols.</p></td></div></tr><tr class="slate-tr " ><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >14</p></td></div><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >Invalid card number</p></td></div><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >&quot;
The Cardholders issuing bank has declined the transaction as the payment card number is incorrectly entered, or does not exist.This indicates a problem with the information entered for the card. Double-check the card number, expiration date, and CVV. If you haven&apos;t already, also ensure that the card has been activated&quot;</p></td></div></tr><tr class="slate-tr " ><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >15</p></td></div><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >No issuer</p></td></div><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >The Cardholders issuer does not exist. Check the card information and try processing the transaction again.Wrong card number (Codes 14 &amp; 15): There are two wrong ways to enter the card number improperly. If the very first digit is incorrect, you&apos;ll see error code 15 for “no such issuers” since the first digit pinpoints the card&apos;s issuing bank.                 If we say more specifically ,The card number entered is wrong since it doesn’t start with a 3 (AMEX), 4 (Visa), 5 (MasterCard), or 6 (Discover).</p></td></div></tr><tr class="slate-tr " ><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >16</p></td></div><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >Approved, update track 3</p></td></div><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >An unspecified bank error has occurred. The Cardholder should attempt to process the transaction again.</p></td></div></tr><tr class="slate-tr " ><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >17</p></td></div><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >Customer cancellation</p></td></div><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >&quot;This indicates that the transaction was authorised and subsequently voided.</p><p class="slate-p " >Voided transactions do not appear on the customer&apos;s statement or form part of your settlement total.&quot;</p></td></div></tr><tr class="slate-tr " ><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >18</p></td></div><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >Customer dispute</p></td></div><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >The Cardholders card issuer has prevented this transaction from taking place due to an ongoing or previous dispute.</p></td></div></tr><tr class="slate-tr " ><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >19</p></td></div><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >Re-enter last transaction</p></td></div><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >The transaction has not been processed and the Cardholder should attempt to process the transaction again. No further information is provided from the bank as to the reason why this was not processed.</p></td></div></tr><tr class="slate-tr " ><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >20</p></td></div><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >Invalid response/acquirer error</p></td></div><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >The bank has declined the transaction because of an invalid format or field. This indicates the card details were incorrect. Check card data entered and try again.</p></td></div></tr><tr class="slate-tr " ><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >21</p></td></div><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >No action taken</p></td></div><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >The Cardholders issuer has indicated there is a problem with the payment card number. The Cardholder should use an alternate payment method, or contact their bank.</p></td></div></tr><tr class="slate-tr " ><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >22</p></td></div><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >Suspected malfunction</p></td></div><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >The Cardholders issuer could not be contacted during the transaction. The Cardholder should check the card information and try processing the transaction again.</p></td></div></tr><tr class="slate-tr " ><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >23</p></td></div><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >Unacceptable transaction</p></td></div><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >An unspecified bank error has occurred. The Cardholder should attempt to process the transaction again.</p></td></div></tr><tr class="slate-tr " ><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >24</p></td></div><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >File update impossible</p></td></div><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >An unspecified bank error has occurred. The Cardholder should attempt to process the transaction again.</p></td></div></tr><tr class="slate-tr " ><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >25</p></td></div><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >Unable to locate record on file</p></td></div><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >The Cardholders card issuer does not recognise the credit card details. The Cardholder should check the card information and try processing the transaction again.</p></td></div></tr><tr class="slate-tr " ><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >26</p></td></div><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >Duplicate reference number</p></td></div><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >The Cardholders card issuer does not recognise the credit card details. The Cardholder should check the card information and try processing the transaction again.</p></td></div></tr><tr class="slate-tr " ><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >27</p></td></div><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >Error in reference number</p></td></div><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >The Cardholders card issuer does not recognise the credit card details. The Cardholder should check the card information and try processing the transaction again.</p></td></div></tr><tr class="slate-tr " ><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >28</p></td></div><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >File is temporarily unavailable for update</p></td></div><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >An unspecified bank error has occurred. The Cardholder should attempt to process the transaction again.A code 28 error happens during this initial authorization process. It simply means there was an issue immediately retrieving the information from the card-issuing bank. Therefore, because of its temporary status, the transaction should be put through again.</p></td></div></tr><tr class="slate-tr " ><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >29</p></td></div><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >File action failed/contact acquirer</p></td></div><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >An unspecified bank error has occurred. The Cardholder should attempt to process the transaction again.</p></td></div></tr><tr class="slate-tr " ><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >30</p></td></div><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >Format error</p></td></div><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >The Cardholders issuer does not recognise the transaction details being entered. This is due to a format error. The Cardholder should check the transaction information and try processing the transaction again.                                                                                                          We can further explain this as &quot;An &quot;Invalid format&quot; error when updating your credit card means that the credit card number was entered with spaces, dashes, or some other character that is not allowed.&quot;</p></td></div></tr></tbody></table></div><p class="slate-p slate-indent-0" style="0px">As for any further inquiries related to the previously mentioned error codes or any codes raised from your side while performing any transaction, 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.</p>

If an error occurs during performing a transaction, you can identify the specific error message and code associated with it. These error messages and codes are designed to help you understand what went wrong and how to fix it. By referencing the error message and code, you can gain a clear understanding of the issue and take appropriate action to resolve it. It's important to review the error message and code carefully to ensure that you address the root cause of the error. By doing so, you can improve the reliability and accuracy of your transactions.

RESPONSE

DESCRIPTION

<h2 class="slate-h2 " >Table Of Contents</h2><ul class="slate-ul " ><li class="slate-li " ><div style="position:relative"><a href="https://developers.paymob.com/egypt/payouts/definitions-and-acronyms" target="_blank">Definitions and Acronyms</a></div></li><li class="slate-li " ><div style="position:relative"><a href="https://developers.paymob.com/egypt/payouts/generate-and-refresh-token-api-endpoint" target="_blank">Generate and Refresh Token API Endpoint</a></div></li><li class="slate-li " ><div style="position:relative"><a href="https://developers.paymob.com/egypt/payouts/instant-cashin-api-endpoint" target="_blank">Instant Cashin API Endpoint</a></div></li><li class="slate-li " ><div style="position:relative"><a href="https://developers.paymob.com/egypt/payouts/cancel-aman-transaction-api-endpoint" target="_blank">Cancel Aman Transaction API Endpoint</a></div></li><li class="slate-li " ><div style="position:relative"><a href="https://developers.paymob.com/egypt/payouts/bulk-transaction-inquiry-api-endpoint" target="_blank">Bulk Transaction Inquiry API Endpoint</a></div></li><li class="slate-li " ><div style="position:relative"><a href="https://developers.paymob.com/egypt/payouts/user-budget-inquiry-api-endpoint" target="_blank">User Budget Inquiry API Endpoint</a></div></li><li class="slate-li " ><div style="position:relative"><a href="https://developers.paymob.com/egypt/payouts/callback-url" target="_blank">CallBack Url</a></div></li><li class="slate-li " ><div style="position:relative"><a href="https://developers.paymob.com/egypt/payouts/response-codes" target="_blank">Response Codes</a></div></li></ul><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 " >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&apos;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 

Sections