Skip to main content

​
Welcome to 88Pay Integration Guides

These guides will walk you through every step of integrating 88Pay into your application. Whether you’re implementing payins, payouts, or both, you’ll find detailed instructions and best practices here.
New to 88Pay? Start with our Getting Started section first.

​
Integration Path

Follow these guides in order for a complete integration:
1

Get API Credentials

Obtain your API Key and Merchant ID from the dashboardRead Guide →
2

Generate Authentication Token

Learn how to generate and manage access tokensRead Guide →
3

Create Operations

Process payments, cashouts, and other transactionsRead Guide →
4

Set Up Webhooks

Receive real-time notifications about transaction statusRead Guide →
5

Check Balance

Monitor your merchant balance and transaction historyRead Guide →

​
Core Integration Guides

Essential guides for implementing payment functionality:

API Credentials

How to obtain and manage your API credentials

Generate Token

Authentication token generation and management

Create Operation

Process payments, cashouts, and transfers

Webhooks

Set up real-time transaction notifications

Balance Inquiry

Check your account balance and settlements

​
Advanced Topics

Take your integration to the next level:

Error Handling

Handle errors gracefully and implement retry logic

Rate Limits

Understand and work within API rate limits

Security Best Practices

Keep your integration secure and compliant

Testing

Test your integration with sandbox environment

​
Payment Flow Overview

Understanding the complete payment lifecycle:

​
Supported Operations

Accept payments from customers through various methods:

​
Available Methods

MethodCodeCategoryCountries
Credit/Debit CardsCARDSCARDAll
Cash PaymentsCASHCASHAll
Bank TransfersBANK_TRANSFERBANKAll
NequiNEQUIWALLETColombia
DaviplataDAVIPLATAWALLETColombia
PayPalPAYPALWALLETAll
USDT (Crypto)USDTCRYPTOAll
Explore Payment Methods →

​
Integration Checklist

Use this checklist to track your integration progress:
  • Create 88Pay account
  • Upload and get documents approved
  • Obtain API credentials
  • Set up development environment
  • Configure sandbox credentials
  • Implement token generation
  • Create first test payment
  • Set up webhook endpoint
  • Handle webhook notifications
  • Implement error handling
  • Test successful payments
  • Test failed payments
  • Test webhook delivery
  • Test token expiration
  • Test rate limiting
  • Switch to production credentials
  • Configure production webhook URL
  • Set up monitoring and alerts
  • Document integration
  • Train support team

​
Integration Patterns

Common implementation patterns for different use cases:
Use Case: Add 88Pay as a payment option in your online store
    // 1. Create payment when user clicks "Pay with 88Pay"
    const payment = await create88PayCharge({
      amount: cart.total,
      currency: 'COP',
      description: `Order #${orderId}`,
      customer_id: user.id,
      return_url: `${siteUrl}/orders/${orderId}/confirmation`
    });
    
    // 2. Redirect to checkout
    window.location.href = payment.urlCheckout;
    
    // 3. Handle webhook notification
    // Update order status when webhook arrives
Full E-commerce Guide →

​
Quick Reference

​
Essential Endpoints

EndpointMethodPurpose
/api/auth/tokenPOSTGenerate authentication token
/api/transactions/chargesPOSTCreate payment charge
/api/transactions/cashPOSTCreate cash payment
/api/transactions/cashout-bank-transferPOSTCreate bank payout
/api/balancePOSTCheck merchant balance
Full API Reference →

​
Required Headers

Authorization: Bearer {access_token}
x-session-id: {session_id}
Content-Type: application/json

​
Common Status Codes

StatusMeaning
PENDINGTransaction initiated, awaiting completion
COMPLETEDTransaction successful
REJECTEDTransaction failed, expired, or cancelled
All Status Codes →

​
Support & Resources

API Reference

Complete technical documentation

Error Codes

Troubleshoot common errors

Best Practices

Tips for optimal integration

Contact Support

Get help from our team

​
Next Steps

Ready to start integrating? Begin with the first guide:

Get Your API Credentials

Learn how to obtain your API Key and Merchant ID