Contents

Update Merchant Metadata

Update the merchant token’s notification URL.

URL

POST https://apple-pay-gateway.apple.com/paymentservices/v1/merchantId/{merchantId}/merchantToken/updateMerchantMetadata

Path Parameters

NameTypeDescription
merchantId Requiredstring

The merchant identifier issued by Apple.

Header Parameters

NameTypeDescription
Accept Optionalstring

The response format the client expects, for example, application/json for JSON.

Content-Type Requiredstring

The format of the data sent in the request body, for example, application/json for JSON payloads.

x-request-id Requiredstring

The header used to uniquely identify the request.

Response Codes

StatusReasonTypeDescription
200OK

Successful response.

400Bad Request
Content-Type: application/json
ErrorResponse

Bad request.

403Forbidden
Content-Type: application/json
ErrorResponse

Authorization failed.

404Not Found
Content-Type: application/json
ErrorResponse

Resource not found.

500Internal Server Error
Content-Type: application/json
ErrorResponse

Internal server error.

Discussion

The merchant server calls this API to update the value of a merchant token’s tokenNotificationURL. This URL receives life-cycle and metadata update notifications from the Apple Pay servers about the Apple Pay merchant token.

HTTP Body

The request body you use to specify the updated merchant metadata.

See Also

Merchant token notification handling