Providing Merchant Validation

POST

https://api.zid.sa/{providerBaseURL}/applepay/initiate

When the merchant validation event is triggered from the Apple Pay JS library, a request to the provider will be needed to obtain the merchant session object that is needed to validate the merchant session. The provider API in turn shall call Apple endpoint “startSession” to get an apple session and return it.

Request

Path Params

Body Params application/json

Examples

Responses

🟢200OK

application/json

Bodyapplication/json

🟠401Unauthorized

🔴500Internal Server error

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://api.paymentprovider.com/applepay/initiate' \
--header 'Content-Type: application/json' \
--data '{
    "validationUrl": "https://apple-pay-gateway.apple.com/paymentservices/startSession",
    "displayName": "Zid Store",
    "domainName": "www.example.com",
    "publishableApiKey": "pk_test_abc123xyz"
}'

Response Example

200 - Example 1

{
    "merchantSession": {}
}

Modified at 2026-01-30 20:55:20

Request Refund