Bank Transfers

Overview

Bank transfers allow customers to pay directly from their bank account without cards or cash. Ideal for larger transactions and B2B payments.

Processing

1-3 business days

Large Amounts

Up to $50,000 USD

Low Fees

Lower than cards

How It Works

Supported Networks

Colombia (PSE)
Mexico (SPEI)
Brazil (PIX)
Other Countries

PSE (Pagos Seguros en Línea)

Type: Real-time online bank transferProcessing: Instant to 24 hoursBanks: All major Colombian banksUser Experience:

Customer redirected to bank
Logs into online banking
Approves payment
Returns to your site

Max Amount: 50,000,000 COP (~$12,500 USD)

Create Bank Transfer Payment

Request

curl -X POST "https://api-sandbox.88pay.io/api/transactions/charges" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "x-session-id: YOUR_SESSION" \
  -H "Content-Type: application/json" \
  -d '{
    "flow": "PAYIN",
    "method_code": "BANK_TRANSFER",
    "method_category": "BANK",
    "amount": 100000,
    "currency": "COP",
    "country": "COL",
    "description": "Invoice #789",
    "customer_id": "company_xyz",
    "notification_url": "https://yoursite.com/webhook"
  }'

Response (Traditional Transfer)

{
  "status": "Success",
  "code": 200,
  "data": {
    "reference": "IP9BD7CJES6",
    "bank_details": {
      "bank_name": "Banco de Colombia",
      "account_number": "1234567890",
      "account_type": "savings",
      "holder_name": "88Pay Colombia SAS",
      "identification": "NIT 900123456",
      "reference_number": "IP9BD7CJES6"
    },
    "amount": 100000,
    "currency": "COP"
  }
}

Response (PSE - Redirect)

{
  "status": "Success",
  "code": 200,
  "data": {
    "urlCheckout": "https://pse.88pay.io/ABC123",
    "reference": "IP9BD7CJES6",
    "amount": 100000,
    "currency": "COP"
  }
}

Customer Experience by Method

PSE (Colombia)
SPEI (Mexico)
PIX (Brazil)

Redirect to PSE

Customer redirected to PSE gateway

Select Bank

Choose their bank from dropdown

Authenticate with bank credentials

Confirm

Review and approve payment

Return

Redirected back to your site

Time: 2-5 minutes

Displaying Bank Instructions

Example UI

// Bank transfer instructions component
function BankTransferInstructions({ data }) {
  return (
    <div className="bank-transfer-instructions">
      <h2>Complete Your Payment</h2>
      
      <div className="instructions-box">
        <h3>Transfer to this account:</h3>
        
        <div className="bank-detail">
          <label>Bank:</label>
          <span>{data.bank_details.bank_name}</span>
          <button onClick={() => copy(data.bank_details.bank_name)}>
            Copy
          </button>
        </div>
        
        <div className="bank-detail">
          <label>Account Number:</label>
          <span>{data.bank_details.account_number}</span>
          <button onClick={() => copy(data.bank_details.account_number)}>
            Copy
          </button>
        </div>
        
        <div className="bank-detail">
          <label>Account Type:</label>
          <span>{data.bank_details.account_type}</span>
        </div>
        
        <div className="bank-detail">
          <label>Beneficiary:</label>
          <span>{data.bank_details.holder_name}</span>
        </div>
        
        <div className="bank-detail highlight">
          <label>⚠️ Reference (IMPORTANT):</label>
          <span className="reference">{data.bank_details.reference_number}</span>
          <button onClick={() => copy(data.bank_details.reference_number)}>
            Copy
          </button>
        </div>
        
        <div className="bank-detail">
          <label>Amount:</label>
          <span>{formatCurrency(data.amount, data.currency)}</span>
        </div>
      </div>
      
      <div className="warning-box">
        <strong>Important:</strong> Include reference number 
        <code>{data.bank_details.reference_number}</code> in your transfer 
        description. This helps us identify your payment.
      </div>
      
      <div className="steps">
        <h3>How to Pay:</h3>
        <ol>
          <li>Open your banking app or website</li>
          <li>Create a new transfer</li>
          <li>Enter the account details above</li>
          <li>Include the reference number in the description</li>
          <li>Confirm the transfer</li>
        </ol>
      </div>
      
      <p className="timeline">
        💡 Your payment will be confirmed within 1-3 business days
      </p>
    </div>
  );
}

Transaction Limits

Country	Method	Min	Max	Processing
🇨🇴 Colombia	PSE	10,000 COP	50,000,000 COP	Instant-24h
🇲🇽 Mexico	SPEI	100 MXN	1,000,000 MXN	Same day
🇧🇷 Brazil	PIX	10 BRL	50,000 BRL	Instant
🇨🇱 Chile	TEF	1,000 CLP	10,000,000 CLP	1-3 days
🇵🇪 Peru	Bank Transfer	50 PEN	50,000 PEN	1-3 days

Webhook Notifications

PENDING
COMPLETED
REJECTED

    {
      "transaction_status": "PENDING",
      "transaction_reference": "IP9BD7CJES6",
      "transaction_payment_method": "BANK_TRANSFER"
    }

Meaning: Awaiting bank transferAction: Wait for customer to transfer

    {
      "transaction_status": "COMPLETED",
      "transaction_reference": "IP9BD7CJES6",
      "transaction_amount": "100000",
      "transaction_payment_method": "BANK_TRANSFER"
    }

Meaning: Transfer received and confirmedAction: Fulfill order, send confirmation

    {
      "transaction_status": "REJECTED",
      "transaction_reference": "IP9BD7CJES6",
      "transaction_payment_method": "BANK_TRANSFER"
    }

Reasons:

Transfer cancelled by customer
Insufficient funds
Bank rejected transfer

Action: Notify customer, offer alternative

Best Practices

Emphasize Reference Number

Make reference number prominent and easy to copy

    <div className="reference-highlight">
      <h3>⚠️ IMPORTANT - Include This Reference:</h3>
      <div className="reference-box">
        <code>{reference}</code>
        <button onClick={copyToClipboard}>Copy</button>
      </div>
      <p>Without this reference, we cannot identify your payment</p>
    </div>

Send Email Confirmation

Email bank details immediately

    await sendEmail({
      to: customer.email,
      subject: 'Bank Transfer Instructions',
      template: 'bank-transfer',
      data: {
        bank_details: data.bank_details,
        amount: data.amount,
        reference: data.reference
      }
    });

Set Realistic Expectations

Clearly communicate processing time

PSE: “Usually confirmed within 24 hours”
SPEI: “Confirmed same day (24/7)”
PIX: “Instant confirmation”
Traditional: “1-3 business days”

Handle Missing References

Some customers forget to include reference

    // Monitor transfers without reference
    app.post('/webhook/unmatched-transfer', async (req, res) => {
      const { amount, sender_name, timestamp } = req.body;
      
      // Try to match by amount + timestamp
      const possibleMatch = await findOrderByAmountAndTime(
        amount, 
        timestamp
      );
      
      if (possibleMatch) {
        // Request customer confirmation
        await sendEmail({
          to: possibleMatch.customer.email,
          subject: 'Confirm Your Payment',
          message: `We received ${amount} from ${sender_name}. Is this yours?`
        });
      }
      
      res.status(200).json({ received: true });
    });

Testing

Sandbox Behavior

Traditional Transfer
PSE (Redirect)
PIX

Bank details returned instantly
Auto-completes after 5 minutes
Webhook sent automatically

    // Test flow
    const payment = await createBankTransfer(data);
    console.log('Account:', payment.bank_details.account_number);
    
    // Wait 5 minutes
    await sleep(300000);
    
    // Webhook should arrive with COMPLETED status

Common Issues

Customer transferred without reference

Problem: Cannot identify paymentSolutions:

Match by amount + customer name + timestamp
Contact customer to confirm
Check bank statement description
Manual reconciliation via support

Prevention:

Make reference mandatory and prominent
Send SMS reminder with reference
Add reference to email subject line

Transfer taking longer than expected

Common for:

Traditional transfers (1-3 business days normal)
Transfers after banking hours
Weekend/holiday transfers

Action:

Check transaction status via API
Contact bank if >3 business days
Keep customer informed

Wrong amount transferred

If customer transferred less:

Partial payment accepted (some countries)
Request remaining balance
Generate new transfer for difference

If customer transferred more:

Accept overpayment
Offer refund of difference
Apply as credit for next purchase

PIX Specific Features

QR Code Display

function PixPayment({ data }) {
  return (
    <div className="pix-payment">
      <h2>Pay with PIX</h2>
      
      <div className="qr-code">
        <img src={data.qr_code_url} alt="PIX QR Code" />
        <p>Scan with your bank app</p>
      </div>
      
      <div className="divider">OR</div>
      
      <div className="pix-key">
        <label>PIX Key:</label>
        <code>{data.pix_key}</code>
        <button onClick={() => copy(data.pix_key)}>
          Copy PIX Key
        </button>
      </div>
      
      <div className="instructions">
        <h3>How to pay:</h3>
        <ol>
          <li>Open your bank app</li>
          <li>Go to PIX section</li>
          <li>Scan QR code or paste PIX key</li>
          <li>Confirm payment</li>
        </ol>
      </div>
      
      <p className="instant">⚡ Instant confirmation</p>
    </div>
  );
}

Next Steps

Webhooks

Handle payment notifications

Testing

Test bank transfers

Country Details

Network-specific information

API Reference

Technical documentation

Available Methods

Overview

Processing

Large Amounts

Low Fees

How It Works

Supported Networks

PSE (Pagos Seguros en Línea)

SPEI (Sistema de Pagos Electrónicos Interbancarios)

PIX

Create Bank Transfer Payment

Request

Response (Traditional Transfer)

Response (PSE - Redirect)

Customer Experience by Method

Displaying Bank Instructions

Example UI

Transaction Limits

Webhook Notifications

Best Practices

Testing

Sandbox Behavior

Common Issues

PIX Specific Features

QR Code Display

Next Steps

Webhooks

Testing

Country Details

API Reference

Available Methods

​Overview

Processing

Large Amounts

Low Fees

​How It Works

​Supported Networks

​PSE (Pagos Seguros en Línea)

​SPEI (Sistema de Pagos Electrónicos Interbancarios)

​PIX

​Create Bank Transfer Payment

​Request

​Response (Traditional Transfer)

​Response (PSE - Redirect)

​Customer Experience by Method

​Displaying Bank Instructions

​Example UI

​Transaction Limits

​Webhook Notifications

​Best Practices

​Testing

​Sandbox Behavior

​Common Issues

​PIX Specific Features

​QR Code Display

​Next Steps

Webhooks

Testing

Country Details

API Reference

Overview

How It Works

Supported Networks

PSE (Pagos Seguros en Línea)

SPEI (Sistema de Pagos Electrónicos Interbancarios)

PIX

Create Bank Transfer Payment

Request

Response (Traditional Transfer)

Response (PSE - Redirect)

Customer Experience by Method

Displaying Bank Instructions

Example UI

Transaction Limits

Webhook Notifications

Best Practices

Testing

Sandbox Behavior

Common Issues

PIX Specific Features

QR Code Display

Next Steps