Download the PHP package rstacode/nass without Composer
On this page you can find all versions of the php package rstacode/nass. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download rstacode/nass
More information about rstacode/nass
Files in rstacode/nass
Informations about the package nass
Nass Payment Gateway — Laravel SDK
Laravel SDK for the Nass Payment Gateway — Iraq's payment processing platform.
Requirements
- PHP 8.1+
- Laravel 10.x, 11.x, 12.x, or 13.x
Installation
Laravel auto-discovers the service provider. Publish the config file:
Configuration
Add the following to your .env file:
Usage
1. Authentication
Login with your merchant credentials to receive a Bearer access token:
2. Create a Transaction
Response example:
3. Check Transaction Status
Note: Status checks are available within 24 hours of transaction initiation. For long-term reference use the
rrnfield.
4. Handling Callbacks
The Nass gateway will POST the transaction result to your notifyUrl:
Callback payload fields:
| Field | Description |
|---|---|
terminal |
Terminal ID |
actionCode |
0 = success |
responseCode |
00 = approved |
card |
Masked card number |
amount |
Transaction amount |
currency |
Currency code (368 = IQD) |
rrn |
Reference number in acquiring bank |
intRef |
Internal reference (used for reversals) |
orderId |
Your order ID (stored 7 days only) |
tranDate |
Transaction date/time |
transactionOrigin |
local or international |
5. Error Handling
UAT Test Cards
Use these cards exclusively in the UAT environment:
| PAN | Expiry | CVV |
|---|---|---|
| 5123450000000008 | 01/39 | 100 |
API Environments
| Environment | Base URL |
|---|---|
| UAT | https://uat-gateway.nass.iq:9746 |
| Production | https://gateway.nass.iq:9746 |
License
MIT
All versions of nass with dependencies
illuminate/support Version ^10.0|^11.0|^12.0|^13.0
illuminate/http Version ^10.0|^11.0|^12.0|^13.0
guzzlehttp/guzzle Version ^7.0