> ## Documentation Index
> Fetch the complete documentation index at: https://docs.jelou.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Usage and configuration

> Add the Kushki node to your Canvas flow, configure its inputs, and test payments in the test environment.

Once connected, the **Kushki** node is available in Canvas and lets you create collection experiences with **embedded WebView** within the conversational flow.

> [!TIP]
>
> If you have not installed the integration yet, follow [Connect in Brain Studio](https://docs.jelou.ai/en/guides/integrations/payments/providers/kushki/connect-in-brain-studio.md) first.

***

## Add the node to Canvas

**1. Open your flow in Canvas**

Open in Brain Studio the flow where you want to add Kushki collection.

**2. Add Kushki node**

Add **Kushki** from the **Canvas** toolbar, in the **Payments** node, or from available payment providers once the integration is installed.

**3. Connect the node at collection point**

Connect the Kushki node after the flow already has the amount and purchase confirmation.

**4. Open configuration panel**

Select the node to open the sidebar and complete **inputs** and review **outputs**.

![Kushki Payment WebView node with payment outputs and Payment data sidebar](https://mintcdn.com/jelouai/3D3ye1Wdwh66cTgk/assets/images/integraciones/pagos/kushki-nodo-datos-del-pago.png?fit=max\&auto=format\&n=3D3ye1Wdwh66cTgk\&q=85\&s=2636240e03dbeecb25aa3d21e1677b14)

Kushki node in Canvas with Payment data panel

***

## Configure the node

> [tab] Inputs
>
> ### Payment data
>
> > [accordion] Customization
> >
> > **Customization** `boolean` (default: false)
> >
> > Enable to define the messages that accompany the payment button.
> >
> > When disabled, Brain Studio uses the default collection message texts.
>
> > [accordion] Payment reason
> >
> > **Payment reason** `string` *required*
> >
> > Descriptive text for the charge. Examples: order number, product, service, or internal reference.
> >
> > You can map it from flow variables, for example `{{$memory.paymentBreakdown.summary}}`.
>
> > [accordion] Taxable amount
> >
> > **Taxable amount** `number` *required*
> >
> > Amount subject to VAT. Numbers only.
> >
> > You can map it from flow variables.
>
> > [accordion] Tax-exempt amount
> >
> > **Tax-exempt amount** `number` *required*
> >
> > Tax-exempt amount. If not applicable, use `0`. Numbers only.
> >
> > You can map it from flow variables.
>
> > [!NOTE]
> >
> > The node in Canvas exposes the outputs **Successful payment**, **Pending payment**, **Payment message sent**, **Failed payment**, and **Error**.
>
> ### Advanced
>
> > [accordion] Environment
> >
> > Shows whether Kushki operates in **Development** or **Production**.
> >
> > If it is in **Development**, you can start **Go live** from here.
>
> > [accordion] Payment button expiration
> >
> > **Payment button expiration** `string`
> >
> > Defines how long the payment button remains valid after being sent.
>
> ![Advanced panel of the Kushki node with Development environment and payment button expiration](https://mintcdn.com/jelouai/3D3ye1Wdwh66cTgk/assets/images/integraciones/pagos/kushki-pasar-a-produccion-avanzado.png?fit=max\&auto=format\&n=3D3ye1Wdwh66cTgk\&q=85\&s=c9b5e0e495348ecfc920c36ed7ed4198)
>
> Advanced tab of the Kushki node

> [tab] Outputs
>
> > [accordion] Successful payment
> >
> > Activates when Kushki confirms the transaction was approved.
> >
> > Recommendations:
> >
> > * confirm the order
> > * issue a receipt or update status in external systems
>
> > [accordion] Pending payment
> >
> > Activates when the transaction is in process or requires later confirmation.
> >
> > Recommendations:
> >
> > * inform the user clearly
> > * avoid creating a second charge while the status is pending
>
> > [accordion] Payment message sent
> >
> > Activates when the payment button message is sent successfully in the conversation.
> >
> > This output does **not** confirm payment. It only indicates the message was sent successfully.
>
> > [accordion] Failed payment
> >
> > Activates when the transaction was rejected, declined, or not completed.
> >
> > Recommendations:
> >
> > * allow controlled retry
> > * offer support or an alternative path
>
> > [accordion] Error
> >
> > Activates on technical errors, provider errors, or communication failures.
> >
> > Recommendations:
> >
> > * log the error
> > * show a contingency message

***

## Test payments in test environment

If Kushki is connected with **test** credentials, you can test checkout with Kushki test data.

> [!NOTE]
>
> In the test environment, payment is fictitious and does not move real money.

**1. Confirm test credentials**

Verify Kushki is installed with test environment credentials.

**2. Configure the node**

Complete **Payment reason**, **Taxable amount**, and **Tax-exempt amount**. In **Advanced**, confirm the environment is **Development**.

**3. Test from WhatsApp**

Trigger the flow from WhatsApp, open Kushki WebView checkout, and complete a test payment.

**4. Validate flow output**

Verify which output the flow continues through:

* **Successful payment**
* **Pending payment**
* **Failed payment**
* **Error**

***

## Go live

If you installed Kushki in **development/test**, start going live from the node **Advanced** tab or from **Marketplace**.

Before operating with real payments:

* Have complete **production** credentials ready
* Use the flow described in [Connect in Brain Studio](https://docs.jelou.ai/en/guides/integrations/payments/providers/kushki/connect-in-brain-studio.md)
* Remember the **\$0.10 USD** cost per transaction in production
* Run a low-amount real test before scaling

***

## Important considerations

> [accordion] Environment depends on installation
>
> With test credentials, use test data. With production credentials, use real data.

> [accordion] Avoid duplicate payments
>
> In pending or failed scenarios, inform clearly before starting another collection attempt.

***

## Next step

> [card] [Coverage and pricing](https://docs.jelou.ai/en/guides/integrations/payments/providers/kushki/coverage-and-pricing.md)
>
> Review Kushki availability by country, currencies, payment methods, and commercial considerations.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.