Ctrlk
Discuss on RedditJoin Slack CommunityContact Us
For the complete documentation index, see llms.txt. This page is also available as Markdown.

EBANX

Configure EBANX as a payout processor on Juspay Hyperswitch for local currency payouts across Latin America via Pix and other local rails.

EBANX connects to Hyperswitch as a PayoutProcessor for cross-border disbursements and local currency payouts across Latin America. It specializes in LATAM markets where global card rails and SWIFT are not the preferred disbursement method. Pix (Brazil's instant payment rail) support is currently in beta.

Authentication

EBANX uses HeaderKey authentication — a single integration key sent on every request.

Credential
Description

Integration Key (API Key)

EBANX integration key. Found in your EBANX merchant portal under API settings.

Supported Payout Methods

Method
Rails / Networks
Regions
Notes

Bank transfers

Pix

Brazil

Instant bank transfer via Brazil's Pix rail. Currently in beta.

Payout Flows

EBANX implements the following Hyperswitch payout flows:

Flow
Description

PoCreate

Creates the payout disbursement in EBANX

PoFulfill

Executes and submits the payout for processing

PoCancel

Cancels a pending payout

Common Failure Modes

Integration key rejected Symptom: EBANX returns 401 Unauthorized. Fix: Verify the Integration Key stored in Hyperswitch matches the key from your EBANX merchant portal. Keys are environment-specific — test keys do not work in production.

Pix key not found Symptom: Payout fails with recipient validation error. Fix: Confirm the recipient's Pix key (CPF, CNPJ, email, phone, or random key) is registered in Brazil's Pix directory. Invalid or unregistered Pix keys will be rejected.

Country not supported Symptom: Payout fails for a non-LATAM destination. Fix: EBANX payouts are limited to supported LATAM countries. Check EBANX's supported country list for payout availability.

Activating EBANX Payouts via Hyperswitch

Prerequisites

  1. An EBANX merchant account with payout capabilities. Contact ebanx.com for onboarding.

  2. A registered Hyperswitch account, accessible from the Hyperswitch control center.

  3. Integration Key from your EBANX merchant portal.

Steps to activate a connector on the Hyperswitch control center

Connector implementation: crates/hyperswitch_connectors/src/connectors/ebanx.rs.

Last updated

Was this helpful?