> ## 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](/en/guides/integraciones/pagos/proveedores/kushki/conectar-en-brain-studio) first.
</Tip>

***

## Add the node to Canvas

<Steps>
  <Step title="Open your flow in Canvas">
    Open in Brain Studio the flow where you want to add Kushki collection.
  </Step>

  <Step title="Add Kushki node">
    Add **Kushki** from the **Canvas** toolbar, in the **Payments** node, or from available payment providers once the integration is installed.
  </Step>

  <Step title="Connect the node at collection point">
    Connect the Kushki node after the flow already has the amount and purchase confirmation.
  </Step>

  <Step title="Open configuration panel">
    Select the node to open the sidebar and complete **inputs** and review **outputs**.

    <Frame caption="Kushki node in Canvas with Payment data panel">
      <img src="https://mintcdn.com/jelouai/BJIoathnR7ANCT6N/assets/images/integraciones/pagos/kushki-nodo-datos-del-pago.png?fit=max&auto=format&n=BJIoathnR7ANCT6N&q=85&s=c6500efb1c7250bed16768bedcf0f60e" alt="Kushki Payment WebView node with payment outputs and Payment data sidebar" width="1154" height="926" data-path="assets/images/integraciones/pagos/kushki-nodo-datos-del-pago.png" />
    </Frame>
  </Step>
</Steps>

***

## Configure the node

<Tabs>
  <Tab title="Inputs">
    ### Payment data

    <AccordionGroup>
      <Accordion title="Customization" icon="message">
        <ParamField body="Customization" type="boolean" default="false">
          Enable to define the messages that accompany the payment button.

          When disabled, Brain Studio uses the default collection message texts.
        </ParamField>
      </Accordion>

      <Accordion title="Payment reason" icon="file-lines">
        <ParamField body="Payment reason" type="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}}`.
        </ParamField>
      </Accordion>

      <Accordion title="Taxable amount" icon="receipt">
        <ParamField body="Taxable amount" type="number" required>
          Amount subject to VAT. Numbers only.

          You can map it from flow variables.
        </ParamField>
      </Accordion>

      <Accordion title="Tax-exempt amount" icon="dollar-sign">
        <ParamField body="Tax-exempt amount" type="number" required>
          Tax-exempt amount. If not applicable, use `0`. Numbers only.

          You can map it from flow variables.
        </ParamField>
      </Accordion>
    </AccordionGroup>

    <Note>
      The node in Canvas exposes the outputs **Successful payment**, **Pending payment**, **Payment message sent**, **Failed payment**, and **Error**.
    </Note>

    ### Advanced

    <AccordionGroup>
      <Accordion title="Environment" icon="server">
        Shows whether Kushki operates in **Development** or **Production**.

        If it is in **Development**, you can start **Go live** from here.
      </Accordion>

      <Accordion title="Payment button expiration" icon="clock">
        <ParamField body="Payment button expiration" type="string">
          Defines how long the payment button remains valid after being sent.
        </ParamField>
      </Accordion>
    </AccordionGroup>

    <Frame caption="Advanced tab of the Kushki node">
      <img src="https://mintcdn.com/jelouai/BJIoathnR7ANCT6N/assets/images/integraciones/pagos/kushki-pasar-a-produccion-avanzado.png?fit=max&auto=format&n=BJIoathnR7ANCT6N&q=85&s=384162aa6b962dda00334667f8d39b41" alt="Advanced panel of the Kushki node with Development environment and payment button expiration" width="1162" height="656" data-path="assets/images/integraciones/pagos/kushki-pasar-a-produccion-avanzado.png" />
    </Frame>
  </Tab>

  <Tab title="Outputs">
    <AccordionGroup>
      <Accordion title="Successful payment" icon="circle-check">
        Activates when Kushki confirms the transaction was approved.

        Recommendations:

        * confirm the order
        * issue a receipt or update status in external systems
      </Accordion>

      <Accordion title="Pending payment" icon="clock">
        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>

      <Accordion title="Payment message sent" icon="paper-plane">
        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>

      <Accordion title="Failed payment" icon="circle-xmark">
        Activates when the transaction was rejected, declined, or not completed.

        Recommendations:

        * allow controlled retry
        * offer support or an alternative path
      </Accordion>

      <Accordion title="Error" icon="triangle-exclamation">
        Activates on technical errors, provider errors, or communication failures.

        Recommendations:

        * log the error
        * show a contingency message
      </Accordion>
    </AccordionGroup>
  </Tab>
</Tabs>

***

## 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.
</Note>

<Steps>
  <Step title="Confirm test credentials">
    Verify Kushki is installed with test environment credentials.
  </Step>

  <Step title="Configure the node">
    Complete **Payment reason**, **Taxable amount**, and **Tax-exempt amount**. In **Advanced**, confirm the environment is **Development**.
  </Step>

  <Step title="Test from WhatsApp">
    Trigger the flow from WhatsApp, open Kushki WebView checkout, and complete a test payment.
  </Step>

  <Step title="Validate flow output">
    Verify which output the flow continues through:

    * **Successful payment**
    * **Pending payment**
    * **Failed payment**
    * **Error**
  </Step>
</Steps>

***

## 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](/en/guides/integraciones/pagos/proveedores/kushki/conectar-en-brain-studio)
* Remember the **\$0.10 USD** cost per transaction in production
* Run a low-amount real test before scaling

***

## Important considerations

<AccordionGroup>
  <Accordion title="Environment depends on installation">
    With test credentials, use test data. With production credentials, use real data.
  </Accordion>

  <Accordion title="Avoid duplicate payments">
    In pending or failed scenarios, inform clearly before starting another collection attempt.
  </Accordion>
</AccordionGroup>

***

## Next step

<Card title="Coverage and pricing" href="/en/guides/integraciones/pagos/proveedores/kushki/cobertura-y-precios" icon="globe">
  Review Kushki availability by country, currencies, payment methods, and commercial considerations.
</Card>