# Payment Provider Integration

## Overview

{% hint style="info" %}
Payment integration in the Returns Portal is currently available for retailers using **Adyen** to process payments.
{% endhint %}

Integrating payments during the return registration process simplifies return transactions for your customers. Return label costs and additional fees are displayed clearly when selecting a return option and labels are only generated upon successful payment. Customers enter their payment details and complete any payment required when registering a return, which also reduces customer service inquiries about unexpected fee deductions from the refund amount.

#### Key Benefits

Enabling payments during the return registration process allows you to recover return costs upfront. Integrated payment procedures can also encourage customers to select alternative return options if configured for your Returns Portal.

## Configuring Payment Provider Integration

The following sections describe the configuration required for the Payment Provider Integration feature.

### Customer Requirements

The following sections describe the information required to integrate specific payment providers.

#### Adyen

For payment integration with Adyen, you need to provide the following:

* An active account with Adyen.\
  You must be able to provide sufficient access to parcelLab and the required credentials to implement the integration. Your Adyen account will be used for integration with parcelLab.

### Implementation Process

To use this feature, please contact the Product Team through your parcelLab account manager with the information specified under the [Customer Requirements](#customer-requirements) section. Further details will be clarified based on the configuration needs for your account.

## Using the Payment Provider Integration

This section describes the process of making a payment during return registration.

{% tabs %}
{% tab title="Enter Payment Details" %}

<figure><img src="https://1156682959-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LPf1Lv1YUuLYva6LrXQ%2Fuploads%2FWGdCXW2hRo4fhHrfKGqn%2FPaymentModalCarrierPage.png?alt=media&#x26;token=807368dd-7438-4984-91c2-08afc5b1c9f1" alt="Popup window for entering payment details on the carrier selection page"><figcaption></figcaption></figure>

After selecting a return carrier, if the option requires payment, a popup window for entering payment details will display.

While payment is being processed, you can display a holding page to inform your customers that the payment is being processed and that their return label can be downloaded as soon as the transaction is successful.
{% endtab %}

{% tab title="Return Confirmation" %}

<figure><img src="https://1156682959-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LPf1Lv1YUuLYva6LrXQ%2Fuploads%2FS4Aohc6deALyxKgJadhy%2FReturnConfirmationPage.png?alt=media&#x26;token=6a0f7e65-e50a-4549-9e38-006c8bd4e8c6" alt="Return confirmation page with generated return label available for download"><figcaption></figcaption></figure>

Once the customer’s payment has been processed, the return confirmation page will display. The return label is generated and available for the user to download after successful payment.

If the transaction fails, both payment and return label generation are cancelled.
{% endtab %}
{% endtabs %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.parcellab.com/docs/retain/returns-portal/features/payment-provider-integration.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.