RISE Holdings API - Quick Start Guide¶

Getting Started in 5 Minutes¶

1. Your Credentials¶

Customer ID: RISE_HOLDINGS_001
API Key: rh_cb03434cf17dd97935f7f53bdad5c4c64265e65b95f93ca906122f8c81507591
Secret Key: 2d2e55e1964f9c7d1b8cccbce4a333d70d2d84745e9eda940ca49ee300cf45e2
Base URL: https://latcom-fix-production.up.railway.app

⚠️ IMPORTANT: Keep these credentials secure. Never commit them to version control.

2. Authentication¶

Include these headers in every API request:

X-API-Key: rh_cb03434cf17dd97935f7f53bdad5c4c64265e65b95f93ca906122f8c81507591
X-Customer-ID: RISE_HOLDINGS_001
Content-Type: application/json

3. Quick Examples¶

Check Your Balance¶

curl -X GET \
  https://latcom-fix-production.up.railway.app/api/balance \
  -H 'X-API-Key: rh_cb03434cf17dd97935f7f53bdad5c4c64265e65b95f93ca906122f8c81507591' \
  -H 'X-Customer-ID: RISE_HOLDINGS_001'

Send Mobile Topup¶

curl -X POST \
  https://latcom-fix-production.up.railway.app/api/enviadespensa/topup \
  -H 'X-API-Key: rh_cb03434cf17dd97935f7f53bdad5c4c64265e65b95f93ca906122f8c81507591' \
  -H 'X-Customer-ID: RISE_HOLDINGS_001' \
  -H 'Content-Type: application/json' \
  -d '{
    "phone": "5512345678",
    "amount": 50,
    "reference": "TEST_001"
  }'

Pay a Bill (CFE Electricity)¶

curl -X POST \
  https://latcom-fix-production.up.railway.app/api/muwe/bill-payment/pay \
  -H 'X-API-Key: rh_cb03434cf17dd97935f7f53bdad5c4c64265e65b95f93ca906122f8c81507591' \
  -H 'X-Customer-ID: RISE_HOLDINGS_001' \
  -H 'Content-Type: application/json' \
  -d '{
    "accountNumber": "123456789012",
    "amount": 500,
    "companySku": "4000035024",
    "reference": "BILL_001"
  }'

Create OXXO Payment Voucher¶

curl -X POST \
  https://latcom-fix-production.up.railway.app/api/muwe/cash-collection/create \
  -H 'X-API-Key: rh_cb03434cf17dd97935f7f53bdad5c4c64265e65b95f93ca906122f8c81507591' \
  -H 'X-Customer-ID: RISE_HOLDINGS_001' \
  -H 'Content-Type: application/json' \
  -d '{
    "amount": 10000,
    "service": "OXXO",
    "reference": "OXXO_001"
  }'

Note: Amount is in centavos (10000 = 100 MXN)

Send SPEI Transfer¶

curl -X POST \
  https://latcom-fix-production.up.railway.app/api/spei/transfer \
  -H 'X-API-Key: rh_cb03434cf17dd97935f7f53bdad5c4c64265e65b95f93ca906122f8c81507591' \
  -H 'X-Customer-ID: RISE_HOLDINGS_001' \
  -H 'Content-Type: application/json' \
  -d '{
    "clabe": "014180606053616829",
    "amount": 100,
    "beneficiaryName": "GUILLERMO AMOR ADERMAN",
    "concept": "Test payment",
    "reference": "SPEI_001"
  }'

4. Available Services¶

Service	Endpoint	Method
Check Balance	`/api/balance`	GET
Mobile Topup	`/api/enviadespensa/topup`	POST
Bill Payment	`/api/muwe/bill-payment/pay`	POST
List Billers	`/api/muwe/bill-payment/companies`	GET
SPEI Transfer	`/api/spei/transfer`	POST
OXXO/SipeCash	`/api/muwe/cash-collection/create`	POST

5. Response Format¶

Success Response:

{
  "success": true,
  "transactionId": "TXN_123456",
  "status": "completed",
  "amount": 50,
  "currency": "MXN"
}

Error Response:

{
  "success": false,
  "error": "Insufficient balance",
  "code": "INSUFFICIENT_BALANCE"
}

6. Testing¶

Use the provided test script:

cd /path/to/latcom-fix
node test-rise-holdings.js

This will test all services and verify your credentials are working.

7. Common Issues¶

401 Unauthorized - Check that your API key is correct - Ensure you're including the X-Customer-ID header

400 Bad Request - Verify all required fields are included - Check data types (phone should be string, amount should be number)

Insufficient Balance - Contact support to add credit to your account

8. Next Steps¶

Review the full API Documentation
Set up webhook endpoints for payment notifications
Implement error handling and retries
Test all services in your environment
Go live!

Need Help?¶

Technical Support: support@riseholdings.com
Full Documentation: See RISE_HOLDINGS_API_DOCUMENTATION.md
Test Script: Run node test-rise-holdings.js

Happy Coding! 🚀