> Portal Navigation:
> 
> - Append `.md` to any URL under `https://dev.wix.com/docs/` to get its markdown version.
> - Pages are either content pages (article or reference text) or menu pages (a list of links to child pages).
> - To get a menu page, truncate any URL to a parent path and append `.md` (e.g. `https://dev.wix.com/docs/sdk.md`, `https://dev.wix.com/docs/sdk/core-modules.md`).
> - Top-level index of all portals: https://dev.wix.com/docs/llms.txt
> - Full concatenated docs: https://dev.wix.com/docs/llms-full.txt

## Resource: Implementation Overview

## Article: Implementation Overview

## Article Link: https://dev.wix.com/docs/api-reference/business-management/payments/payment-service-provider-service-plugin/implementation-overview.md

## Article Content:

# Implementation Overview

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.

## Implementing Endpoints

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:
* [**Connect Account**](https://dev.wix.com/docs/api-reference/business-management/payments/payment-service-provider-service-plugin/accounts/connect-account.md): This endpoint is called when a merchant connects their PSP account to a Wix site. Learn more about [Connecting Accounts](https://dev.wix.com/docs/api-reference/business-management/payments/payment-service-provider-service-plugin/connecting-accounts.md).
* [**Create Transaction**](https://dev.wix.com/docs/api-reference/business-management/payments/payment-service-provider-service-plugin/transactions/create-transaction.md): This endpoint is called when a buyer initiates a payment on a Wix site. Learn more about [Processing Payments](https://dev.wix.com/docs/api-reference/business-management/payments/payment-service-provider-service-plugin/processing-payments.md).

* [**Refund Transaction**](https://dev.wix.com/docs/api-reference/business-management/payments/payment-service-provider-service-plugin/refunds/refund-transaction.md): This endpoint is called when a merchant initiates a payment on the Wix platform. Learn more about [Processing Refunds](https://dev.wix.com/docs/api-reference/business-management/payments/payment-service-provider-service-plugin/processing-refunds.md).

> **Note:**
> There are 2 optional endpoints for PSPs that have enabled **Full Auth Capture** for card payments to implement:
> * [**Capture Transaction**](https://dev.wix.com/docs/rest/business-management/payments/service-plugins/payment-service-provider-service-plugin/transactions/capture-transaction.md): This endpoint is called when a transaction is captured. Learn more about [Capturing and Voiding Payments](https://dev.wix.com/docs/rest/business-management/payments/service-plugins/payment-service-provider-service-plugin/capturing-and-voiding-payments.md).
> * [**Void Transaction**](https://dev.wix.com/docs/rest/business-management/payments/service-plugins/payment-service-provider-service-plugin/transactions/void-transaction.md): This endpoint is called when a transaction is voided. Learn more about [Capturing and Voiding Payments](https://dev.wix.com/docs/rest/business-management/payments/service-plugins/payment-service-provider-service-plugin/capturing-and-voiding-payments.md).

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 [UTF-8](https://en.wikipedia.org/wiki/UTF-8) 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 [Wix Developers Center](https://dev.wix.com/).

For general information about implementing endpoints, see [Validate Endpoint Requests](https://dev.wix.com/docs/api-reference/business-management/payments/payment-service-provider-service-plugin/validate-endpoint-requests.md) and [Idempotency](https://dev.wix.com/docs/api-reference/business-management/payments/payment-service-provider-service-plugin/idempotency.md).

## Implementing Webhooks

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 [Submit Event](https://dev.wix.com/docs/api-reference/business-management/payments/payment-service-provider-service-plugin/callbacks/submit-event.md) API. Learn more about [sending webhooks](https://dev.wix.com/docs/api-reference/business-management/payments/payment-service-provider-service-plugin/webhooks.md).

## Sample Implementation Flows

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:
* [Account connection flows](https://dev.wix.com/docs/api-reference/business-management/payments/payment-service-provider-service-plugin/connecting-accounts.md)
* [Payment flows](https://dev.wix.com/docs/api-reference/business-management/payments/payment-service-provider-service-plugin/sample-payment-flows.md)
* [Capture and Void Flows](https://dev.wix.com/docs/rest/business-management/payments/service-plugins/payment-service-provider-service-plugin/sample-capture-and-void-flows.md).
* [Refund flows](https://dev.wix.com/docs/api-reference/business-management/payments/payment-service-provider-service-plugin/sample-refund-flows.md)

If you need assistance with your integration, feel free to contact the Wix team.