Payout Account Verification
This feature should enable you to verify the details of an account (destination) before sending a payout to it.
Currently, on STC Pay wallet is supported.
Prerequisites
To test the account verification sandbox you will need to have a test account at Moyasar, create a test account using the following link:
Once you have created the test account, navigate to Settings -> API Keys
and copy your secret test API key.
The key should start with the following prefix: sk_test_
When you are ready to use the live account, please contact our support team to enable this feature for you.
Example
curl -u "sk_test_123:" --location 'https://api.moyasar.com/v1/account_verifications' \
--header 'Content-Type: application/json' \
--data '{
"type": "stcpay",
"id": "VALID_NATIONAL_ID_OR_IQAMA_ID",
"mobile": "VALID_SAUDI_NUMBER"
"consented_at": "2025-02-05 11:00:00 +0300",
}'
POST /v1/account_verifications HTTP/1.1
Host: api.moyasar.com
Content-Type: application/json
Authorization: Basic c2tfdGVzdF8xMjM6
{
"type": "stcpay",
"id": "VALID_NATIONAL_ID_OR_IQAMA_ID",
"mobile": "VALID_SAUDI_NUMBER"
"consented_at": "2025-02-05 11:00:00 +0300",
}
Response body:
{
"id": "ee270205-afce-437f-bfb5-ebd173a8e207",
"correct": true
}
The correct
value indicates if the account is verified or not. If you want to manipulate the result for testing purposes, please make the hours in the consented_at
odd or even.