Local card payments in Saudi Arabia

You can make local card payments in Saudi Arabia.

Currency: SAR
Minimum payment amount: 1 SAR
Maximum payment amount: unlimited
Available payment systems: Visa Credit, Visa Debit, Mastercard Credit, Mastercard Debit, Mada

To make a payment, complete the standard steps.

info

If you use our widget, pass the mandatory parameters in the session/create method.
Otherwise, you can pass the mandatory parameters either in session/create or in session/start/payment.

Mandatory parameters

The parameters listed below are not the complete set of fields you need to transmit. They represent only the minimum required parameters necessary to process a payment in this specific country. Check all the parameters

Name	Type	Description
amount_details	object	Payment amount details
amount	int	Payment amount in decimal format. To send 100 SAR, write 10000
currency	string	ISO 4217 currency code. Case insensitive. Always: sar
payment_details	object	Payment data
sender	object	Sender details
full_name	string	Sender's full name (3–50 characters)
participant_details	object	Information on the payment participants
sender	object	Sender details
email	string	Sender's email address (up to 64 characters before @)
document	string	National ID card (10 digits)

Request example

curl -X POST \
  https://demo.smart-glocal.com/api/v1/session/start/payment \
  -H 'content-type: application/json' \
  -H 'X-PARTNER-PROJECT: your_project_name' \
  -H 'X-PARTNER-SIGN: signature' \
  -d '{
    "session_id": "ps_3230",
    "payment_details": {
      "type": "card",
      "card": {
        "type": "bank_card",
        "bank_card": {
          "number": "4242424242424242",
          "expiration_month": "10",
          "expiration_year": "40",
          "security_code": "123"
        }
      },
      "sender": {
        "full_name": "Sender's full name"
      }
    },
    "amount_details": {
        "amount": 10000,
        "currency": "sar"
    },
    "customer": {
      "reference": "lucky"
    },
    "payment_options": {
      "recurrent": false,
      "return_url": "https://website.com"
    },
    "participant_details": {
        "sender": {
            "document": "1234567890",
            "email": "janedoe@mymail.com"
        }
    }
  }'