RLX API Documentation
A API da RLX Holdings permite que comerciantes em Moçambique e Angola processem pagamentos via telemóvel de forma automatizada e segura.
1. Autenticação
A autenticação é feita via Bearer Token. Solicite as suas credenciais à administração da RLX.
Authorization: Bearer SEU_TOKEN_AQUI
2. Gateways Suportados
Nossa API é agnóstica e suporta os principais métodos de pagamento da região:
- e-Mola (Movitel Moçambique)
- M-Pesa (Vodacom Moçambique)
3. Iniciar Pagamento (STK PUSH)
POST https://checkout.rlxl.ink/api.php
Regra de Taxas: 11% sobre a transação.
Proteção de Margem: Se 11% for inferior a 7.00 MT, será aplicada a taxa mínima fixa de 7.00 MT.
Exemplo em PHP
PHP
$ch = curl_init('https://checkout.rlxl.ink/api.php');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
'Authorization: Bearer SEU_TOKEN',
'Content-Type: application/json'
]);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode([
'phone' => '865459392',
'amount' => '100.00',
'method' => 'emola', // ou 'mpesa'
'nome_cliente' => 'Joao Chimirre'
]));
$response = curl_exec($ch);
Exemplo em Node.js (Axios)
NODE.JS
const axios = require('axios');
axios.post('https://checkout.rlxl.ink/api.php', {
phone: '84XXXXXXX',
amount: '50.00',
nome_cliente: 'João Maria'
}, {
headers: { 'Authorization': 'Bearer SEU_TOKEN' }
}).then(res => console.log(res.data));
Exemplo em Python
PYTHON
import requests
url = "https://checkout.rlxl.ink/api.php"
headers = {"Authorization": "Bearer SEU_TOKEN"}
payload = {
"phone": "865459392",
"amount": "10.00",
"nome_cliente": "Cliente RLX"
}
response = requests.post(url, json=payload, headers=headers)
print(response.json())
4. Resposta da API
Se o PUSH for enviado com sucesso ao telemóvel do cliente, você receberá:
{
"status": "success",
"partner_transaction_id": "RLX_123456",
"message": "Aguardando PIN no telemóvel"
}
