🇸🇦Saudi Arabia

Wallets

• payout_method.type = wallet

• payout_method.payment_method = wallets

payout_method_details Parameter	Type	Required	Description
phone_number	string	Yes	E164 format
bank_code	string	Yes	“STCPAY”

Example Wallet Payload

Example Request

{
  "payout_method": {
    "type": "wallet",
    "payment_method": "wallets",
    "beneficiary": {
      "name": "John Doe",
      "payout_method_details": {
        "phone_number": "[phone]",
        "bank_code": "STCPAY"
      }
    }
  },
  "amount": {
    "value": 500,
    "currency_code": "SAR"
  },
  "country_code": "SA",
  "purpose": "salaries",
  "request_id": "unique_request_id"
}

Example Response

{
    "purpose": "SALARIES",
    "reference": null,
    "id": "a7cd5204-9a8d-4136-8813-86016aa72f5b",
    "payout_method": {
        "type": "wallet",
        "payment_method": "sa_wallets",
        "beneficiary_details": {
            "name": "John Doe"
        }
    },
    "amount": {
        "value": 500,
        "currency_code": "SAR"
    },
    "country_code": "SA",
    "request_id": "unique_request_id",
    "created_at": 1710128069
}

Bank Transfer

• payout_method.type = bank_transfer

• payout_method.payment_method = bank_transfer

payout_method_details Parameter	Type	Required	Description
account_name	string	Yes	Max 255 char. Send the same value as beneficiary.name
account_number	string	Yes	IBAN. 24 char. E.g. SA0380000000608010167519
bank_code	string	Yes	See “Saudi Arabia Bank Codes” below

Example Bank Transfer Payload

Example Request

{
  "payout_method": {
    "type": "bank_transfer",
    "payment_method": "bank_transfer",
    "beneficiary": {
      "name": "John Doe",
      "payout_method_details": {
        "account_name": "John Doe",
        "account_number": "SA0380000000608010167519",
        "bank_code": "SNBK"
      }
    }
  },
  "amount": {
    "value": 1000,
    "currency_code": "SAR"
  },
  "country_code": "SA",
  "purpose": "revenue_share",
  "request_id": "unique_request_id"
}

Example Response

{
    "purpose": "REVENUE_SHARE",
    "reference": null,
    "id": "ff3aa74a-402b-44b9-8665-a4e09dea2da3",
    "payout_method": {
        "type": "bank_transfer",
        "payment_method": "sa_bank_transfer",
        "beneficiary_details": {
            "name": "John Doe"
        }
    },
    "amount": {
        "value": 1000,
        "currency_code": "SAR"
    },
    "country_code": "SA",
    "request_id": "unique_request_id",
    "created_at": 1709279556
}

Saudi Arabia Bank Codes

Type	Name	Bank Code
Wallet	STC Pay	STCPAY
Bank Transfer	Saudi National Bank	SNBK
	Al Rajhi Bank	RJHI
	Riyad Bank	RIBL
	Saudi Awwal Bank	SABB
	Arab National Bank	ARNB
	alinma bank	INMA
	Banque Saudi Fransi	BSFR
	Saudi Investment Bank	SIBC
	Bank AlJazira	BJAZ
	Bank AlBilad	ALBI
	Gulf International Bank Saudi Arabia (GIB-SA)	GULF
	STC bank	STCJ
	Emirates NBD	EBIL
	National Bank of Bahrain (NBB)	NBOB
	National Bank of Kuwait (NBK)	NBOK
	Muscat Bank	BMUS
	Deutsche Bank	DEUT
	BNP Paribas	BNPA
	J.P. Morgan Chase N.A	JPMG
	National Bank Of Pakistan (NBP)	NBPA
	T.C.ZIRAAT BANKASI A.S.	TCZB
	Industrial and Commercial Bank of China (ICBC)	ICBK
	Qatar National Bank	QNBA
	MUFG Bank, Ltd.	BOTK
	First Abu Dhabi Bank	FABM
	Credit Suisse Bank	CRES
	Standard Chartered Bank	SCBL
	National Bank of Iraq	NBIQ