In order to integrate with Wix, a Payment Service Provider (PSP) needs to implement several endpoints and support sending webhooks to Wix. This article provides an overview of the integration process.
In order to integrate with Wix, a Payment Service Provider (PSP) needs to implement 3 endpoints. Wix calls these endpoints at different points when merchants and buyers interact with Wix sites.
The endpoints are:
- : This endpoint is called when a merchant connects their PSP account to a Wix site. Learn more about .
- : This endpoint is called when a buyer initiates a payment on a Wix site. Learn more about .
- : This endpoint is called when a merchant initiates a payment on the Wix platform. Learn more about .
Wix calls these endpoints using
POST HTTP requests. The requests always have a
"Content-Type" header with the value
"application/json; charset=utf-8". The request body is always in JSON format. The PSP must respond to valid requests with an HTTP status code of
200 and a JSON response body with character encoding. Wix interprets any other response as a failure.
You can use any URL for your endpoints. Let Wix know which URLs to call by configuring them in the .
For general information about implementing endpoints, see and .
In addition to the endpoints, PSPs must send webhooks to Wix. These webhooks are used to:
- Confirm payment events.
- Confirm refund events.
- Notify Wix about any changes to a payment or refund status.
Webhooks are sent using the API. Learn more about .
This reference includes detailed sample flows for a number of common use cases. The samples also explain when and how to send webhooks.
To learn more see:
If you need assistance with your integration, feel free to contact the Wix team.