SADAD MOI payment

SADAD MOI Payment API enables businesses to securely initiate payments for Ministry of Interior (MOI) services through the SADAD ecosystem using a single API integration.

This service allows organizations to automate government fee payments, streamline operational workflows, and provide seamless payment experiences for customers and business users.

The API supports various MOI payment services including residency services, visa fees, traffic violations, permits, and other government-related payments supported by the participating banks and the SADAD network.

workflows.

Important information

The user must provide the valid credentials in the header
Encrypted and valid Signature and an active Access Token
Request format as specified with all the mandatory details with appropriate request tags
Ensure that the SequenceNumber is unique for each transaction. Payments with same sequence number appear as duplicate transactions and affects their processing and enquiry operations.

Domain details
Environment
Domain
Rate/Limit
Sandbox
sandboxapi.onesingleview.com
3 Calls per Minute
Production/LIVE
To be provided upon onboarding
Based on contract

Environment	Domain	Rate/Limit
Sandbox	sandboxapi.onesingleview.com	3 Calls per Minute
Production/LIVE	To be provided upon onboarding	Based on contract

Make SADAD MOI Payment

Endpoint details

Endpoint URL	Method	Authentication requirements
`/api/v2/sadad/moi/payment`	POST	`CompanyId` `SVReferenceID` `DateTimeStamp` `Device` `Authorization: Bearer`

Sample request

Initiate MOI Payment Request

curl --location 'https://sandboxapi.onesingleview.com/api/v2/sadad/moi/payment'
--header 'CompanyId: MYCOMPANY'
--header 'SVReferenceID: SV150619940615'
--header 'DateTimeStamp	:2025-01-02T10:20:39'
--header 'Device: Web'
--header 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJkYXRhIjoiTDNyMmpxV29JS2I4MTNodDBNMlZ4WGpFZmR6WFNWaTFad3B5QnlkOVpHelZXR2ZwUmFQNUV1TXl6S1Aybi94Y0lwR2V5STNNMkdPL1pqakd4ZG0yclJKUkdhRXlaWGNpWnZnOHArMWIyOGtOQTVkZ0VKajVVSEdiTmtNPSIsImlhdCI6MTczNTgwMTQ3NywiZXhwIjoxNzM1ODA1MDc3fQ.Bh7LFkvxNFrLe9dmH5rURWjGpES-u4z2EGeyrNM7z6E'
--header 'Content-Type: application/json'
--data '{
    "Message": {
        "OSVSadadMOIPaymentRequest": {
            "TransactionType": "SMP",
            "MessageDescription": "Renew Iqama Payment",
            "BankCode": "GIB",
            "CompanyCode": "Singleview",
            "AccountNumber": "20000005639",
            "TransactionData": {
                "SequenceNumber": "82171029",
                "BillerId": "090",
                "ServiceCode": "002",
                "ID": "4035260050",
                // Service-specific tags - insert here
                "FeeReferenceId": "545",
                "SadadReferenceId": "54",
				"PmtIdType": "SPTN",  
				"POINum": "1000501050",
				"POIType": "Unified ID"
            }
        }
    },
    "Signature": "HmgMnSuACM8Y2rvDXg3wV6VgCp5KGrt8Wvj6lJB/1va2asaMUKPznYOi5xrByB6dAhBeKnIl8Q34+Rn+uGTU6MKgFk+1Nlg8EwsOQs8vD12DOVyLoEJD/pIxnVW97gje80PCGjvFG0TQkZDqpzW6Dgtho5BEh7KddYvvRI2Z3TiyFU5Qou1fOrNvbcYIublg68xQdHQl8XhtlhVXqPrAhmgqe41WGpFvIAc4eQvd3RmI1RKri5wX5qdOUbj1SINtk2dIr9S6/n/MuCyKi/FM52B1DNuj5kru61uF57/dOujGdZnOANvuMulCYolLn1hjjda23tt88AetgaHimUAJ+A=="
}'

Request parameters

JSON Tag	Requirement	Description	Data type
Message	Mandatory	Header information	Object
OSVSadadMOIPaymentRequest	Mandatory	Root node containing all the SADAD MOI payment information	Object
TransactionType	Mandatory	Type of transaction to be mentioned as `SMP`	String
MessageDescription	Mandatory	Description of the MOI payment	String
BankCode	Mandatory	Unique code identifying the bank processing the payment	String
CompanyCode	Mandatory	Unique company code associated with the transaction	String
AccountNumber	Mandatory	Unique bank account number from which the payment is made for SADAD MOI	String
TransactionData	Mandatory	Tag carrying information on transaction and service-specific payment details	Object
SequenceNumber	Mandatory	Unique sequence number of the payment generated by the client for the transaction	String
BillerID	Mandatory	Unique SADAD biller identification details Refer SADAD MOI Info	String
ServiceCode	Mandatory	Code identifying the MOI service Refer SADAD MOI Info	String
ID	Mandatory	Customer or transaction identifier required for the service	String
`Service-specific Tags`	Conditional	Additional tags required for the selected MOI service Refer SADAD MOI Info	String
FeeReferenceId	Conditional	Reference ID for the applicable fee Not required for SAB, AlRajhi, and GIB	String
SADADReferenceId	Conditional	SADAD reference ID associated with the transaction Not required for SAB, AlRajhi, and GIB	String
PmtIdType	Conditional	Payment identification type Mandatory for Riyadh Bank	String
POINum	Conditional	Point-of-identification number used for the payment Mandatory for ANB	String
POIType	Conditional	Type of point-of-identification number. Mandatory for ANB	String

Sample response

Initate MOI Payment Response

{
    "OSVSadadMOIPaymentResponse": {
        "TransactionType": "SMP",
        "CompanyCode": "Singleview",
        "BankCode": "GIB",
        "StatusCode": "Completed",
        "StatusDetail": "Payment processed successfully. Kindly check account statement after statement for settlement update. Contact SingleView support if no update is reflected.",
        "TransactionData": {
            "SequenceNumber": "82171028",
            "BillerID": "090",
            "ServiceCode": "002",
            "ID": "4035260050",
            "FeeReferenceId": "545",
            "SadadReferenceId": "54",
            "BankReference": ""
        }
    }
}

Response parameters

Meta Tag	Description	Data type
OSVSadadMOIPaymentResponse	Root tag carrying SADAD MOI payment response	Object
TransactionType	Type of response message represented as `SMP`	String
CompanyCode	Unique company code associated with the transaction	String
BankCode	Unique code of the bank processing the payment	String
StatusCode	Tag indicating the processing status of the payment request	String
StatusDetail	Tag providing additional information about the payment status	String
TransactionData	Tag carrying the transaction-specific response details	Object
SequenceNumber	Sequence number returned for the payment transaction	String
BillerID	SADAD biller identifier	String
ServiceCode	Code identifying the MOI service	String
ID	Customer identifier for SADAD MOI service	String
FeeReferenceId	Reference ID for the applicable fee	String
SadadReferenceId	SADAD reference ID associated with the payment	String
BankReferenceId	Reference returned by the bank for the payment transaction	String

Status Codes & Information

StatusCode	StatusDetail
Completed	Payment processed successfully. Kindly check account statement after some time for settlement update. Contact SingleView support if no update is reflected. or Payment is being processed by the bank. Please check account statement after some time for settlement update. Contact SingleView support if no update is reflected.
Failed	Bank response description
Response_Timeout	Timeout! Unable to get response from the bank. Please contact SingleView support.

StatusCode

StatusDetail

Completed

Payment processed successfully. Kindly check account statement after some time for settlement update. Contact SingleView support if no update is reflected.

Payment is being processed by the bank. Please check account statement after some time for settlement update. Contact SingleView support if no update is reflected.

Failed

Bank response description

Response_Timeout

Timeout! Unable to get response from the bank. Please contact SingleView support.

Categories

GENERAL INFORMATION

GETTING STARTED

AUTHENTICATION

Data APIs

Payment APIs

SADAD

Virtual Accounts

SME Onboarding (Draft)

RESOURCES

API Archives

Domain details

Make SADAD MOI Payment

Endpoint details

Sample request

Sample response

Status Codes & Information