Creates a new Apple Pay payment session for processing payments through Apple Pay gateway. In case of success, the request will return a response with status 201.
POST
REQUIRED
REQUIRED
REQUIRED
REQUIRED
REQUIRED
REQUIRED
REQUIRED
400Request error.
invalid_request
The request body is malformed or a required field is missing. Check the JSON structure and the required parameters.
invalid_parameter
One of the parameters has an invalid value or format. Check the accepted values for each field.
401Authentication error.
unauthorized
The credentials sent are invalid or absent. Check that you are sending valid credentials for the environment you are using.
500Server error.
internal_server_error
An internal server error occurred. Wait a moment and try again. If the problem persists, contact Support with the x-request-id.
curl -X POST \
'https://api.mercadopago.com/applepay/v1/session'\
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer APP_USR-8*********88776-122*********fc20dede6*********a497d7225*********64' \
-H 'X-Product-ID: YOUR_PRODUCT_ID' \
-H 'X-Public-Key: APP_USR-xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx' \
-d '{
"id": "CERTIFICATE_ID_MERCHANT",
"merchantIdentifier": "merchant.your-identifier",
"domainName": "your-domain.com",
"displayName": "My store",
"initiative": "web",
"initiativeContext": "your-domain.com",
"validationURL": "https://apple-pay-gateway.apple.com/paymentservices/startSession"
}'{
"epochTimestamp": 1768253984908,
"expiresAt": 1768257584908,
"merchantSessionIdentifier": "SSH1920C0C97402...7B1B1A97F33C9C3",
"nonce": "124074e7",
"merchantIdentifier": "10DDB60D113BB4...CDF76292133",
"domainName": "your-domain.com",
"displayName": "My store",
"signature": "308006092...2f5d0c8000000000000",
"operationalAnalyticsIdentifier": "My store:10DDB60D113BB4...CDF76292133",
"pspId": "psp-id-value",
"retries": 0
}