Who should use this guideThis guide is intended for merchants who:
- Use Payrails as a payment orchestrator
- Use Noon Payments for card and wallet processing in Saudi Arabia, Egypt or the UAE
- Have an active Noon Payments account with an application set up
Create a Noon Payments integration in Payrails
- Log in to the Payrails portal.
- Go to Settings → Integrations.
- Select Add instance to create a new integration configuration.
- Select the workspaces where this integration should be available.
About workspacesWorkspaces determine where this integration is available. They let you isolate provider setups by region or business line, or share the same configuration across multiple workspaces.
Step 1: Choose the integration type
- Select Payment.
- Continue to the next step.
Step 2: Choose the provider
- Select Noon Payments.
- Continue to the next step.
Step 3: Configure your Noon Payments integration
Integration instance name
An integration instance is a specific payment provider setup in Payrails. You can create multiple instances for different regions, currencies, or business needs. Choose a clear, consistent name, as it is used in routing.In Payrails
- Enter an Instance name for your integration, for example
merchant_noon.
Account details
In Noon Payments- In the Noon Payments merchant panel, go to Account Settings and open Applications.
- Select + Application, enter a name, give it the roles your integration needs, and save.
- Search the list again to find the new application, and copy its business identifier, application identifier and application key.
Credentials
In Payrails
Payrails sends requests to the Noon Payments test environment in test mode and to the live environment in live mode, so use the keys for the matching environment.
Payment methods
In Payrails- Select Card, Apple Pay or both.
Webhooks or notifications
In Payrails- Copy the Notification URL shown under Account configuration at the top of the integration form.
- In the merchant panel, go to Payment Settings → Webhooks.
- Select + Webhook and enter the Payrails notification URL.
- Open the webhook you created and copy its secret key. If the webhook doesn’t show in the list, select your business and search again.
- Paste the secret key into Notification Key in Payrails, and save.
Request fields for Noon Payments
Send these fields in the authorize request for card payments, in addition to the standard authorize fields. Required fields must be present for the payment to succeed. Payrails sends Optional fields to Noon Payments when you include them. For more about meta fields, refer to Meta fields.Configure Noon Payments settings
Some Noon Payments integration settings change how Payrails processes your payments. The portal shows the same description when you hover over each setting.Enable Mada CVV Patching
Turn on Enable Mada CVV Patching if you collect the CVV again when a customer pays with a saved mada card. Payrails then adds that CVV to the payment it sends to Noon Payments.Enable PAN-Based MIT
Turn on Enable PAN-Based MIT to process merchant-initiated subscription payments with the card number instead of the Noon Payments card token. Payrails then doesn’t ask Noon Payments to tokenize the card on the first payment, and sends the stored card number on each merchant-initiated payment.Enable the integration
In Payrails- Select Save account to enable the integration.
- Confirm the integration shows as Enabled.
Next steps
- Run a test payment in the Noon Payments test environment.
- Verify that:
- The payment appears in the Noon Payments merchant panel.
- The payment status updates correctly in Payrails.
- Once verified in test mode, repeat the setup in live mode.