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

# Test a gateway before publishing it

> Use the test checkout to validate the full flow before activating your custom gateway in production.

When your gateway has credentials connected (the wizard's **Connect** step), **Payments → Integrations** shows a **Test** action. It opens the test checkout panel so you can validate the full cycle before production.

## How to test

<Steps>
  <Step title="Fill in the test data">
    Enter order and customer data: name, phone, reference id, amounts, tax, and currency. Optional fields only appear if your body template or headers use them.

    <Frame caption="Test checkout panel, with the order and customer data">
      <img src="https://mintcdn.com/jelouai/5kQz7Vl-QmvhNoPW/assets/images/integraciones/pagos/personalizadas/probar-checkout.png?fit=max&auto=format&n=5kQz7Vl-QmvhNoPW&q=85&s=9684eb3e40477a3eda589f557d0fad73" alt="Test checkout panel of a custom gateway, with name, phone, amount, and currency fields" width="696" height="990" data-path="assets/images/integraciones/pagos/personalizadas/probar-checkout.png" />
    </Frame>
  </Step>

  <Step title="Review the preview">
    The panel shows live how the request looks with placeholders already replaced, before anything is sent to the PSP.
  </Step>

  <Step title="Generate the test payment">
    On confirm, Jelou calls your gateway and shows the resulting **paylink** with the PSP response, or an error message if it's rejected.
  </Step>
</Steps>

<Note>
  The test panel includes a return URL field. It does not include cancellation or channel/user identifiers.
</Note>

Run this flow against the PSP's **sandbox** or test mode before going to production or using the gateway in a live Brain flow.

## Checklist before production

<Steps>
  <Step title="JelouPayments credentials">
    Confirm your company has JelouPayments credentials configured.
  </Step>

  <Step title="Correct environment">
    Validate first in **Sandbox** (or the PSP's test mode) before creating the **Production** equivalent.
  </Step>

  <Step title="PSP credentials">
    Every secret your PSP needs is declared, and sensitive ones are typed as **Secret**.
  </Step>

  <Step title="Verified request">
    The URL, method, body, payment link path, and transaction id path match the PSP's real API—verified with **Test**.
  </Step>

  <Step title="Valid placeholders">
    Review body, headers, and status check against the [placeholder reference](/en/guides/integraciones/pagos/personalizadas/variables-y-placeholders).
  </Step>

  <Step title="Return and status (if applicable)">
    If your PSP redirects after payment, the transaction id parameter matches what it adds to the URL. If you use a status check, the **Success / Failed / None** mapping is complete.
  </Step>

  <Step title="Webhook (if applicable)">
    Signature header configured if the PSP signs webhooks, correct payload paths, and every relevant event mapped to **Success**, **Failed**, or **None**.
  </Step>

  <Step title="Shared webhook secret">
    The generated or rotated secret is also configured in the PSP's dashboard.
  </Step>

  <Step title="Full test checkout">
    You generated a real sandbox paylink, completed a payment end to end, and the resulting status is the expected one.
  </Step>

  <Step title="Production">
    <Warning>
      Production credentials can create a real charge. Use the PSP's test mode when it exists. If it doesn't, run only an authorized minimum-amount transaction and define its void or refund before continuing.
    </Warning>

    Switch to **Production**, repeat the test checkout with production credentials, and re-verify webhook signature validation end to end.
  </Step>
</Steps>

## Activation in Brain Studio

A newly created gateway **doesn't appear immediately** in the Payment node selector. Jelou verifies the configuration in the background and marks it **active** when ready. You can't force that step from the UI.

<Note>
  Plan some time between finishing the wizard and being able to use the gateway inside a Brain flow.
</Note>

## Next steps

<CardGroup cols={2}>
  <Card title="Use in Brain Studio" href="/en/guides/integraciones/pagos/personalizadas/usar-en-brain-studio" icon="diagram-project">
    Configure the Payment node once your gateway is active.
  </Card>

  <Card title="Create a custom gateway" href="/en/guides/integraciones/pagos/personalizadas/crear-pasarela" icon="wand-magic-sparkles">
    Go back to the wizard if you need to adjust a step.
  </Card>
</CardGroup>
