Documentação da API

curl -X POST https://api.laranja.site/api/v2/oauth/token \
  -H "Authorization: Basic czBtZUNsaWVudElk..." \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -d 'grant_type=client_credentials'

# 200 OK
{
  "access_token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
  "expires_in": 3600
}

curl -X POST https://api.laranja.site/api/v2/auth/login \
  -H "Content-Type: application/json" \
  -d '{
    "email": "fulano@example.com",
    "password": "Senha-Forte!123"
  }'

# 200 OK
{
  "success": true,
  "access_token": "eyJhbGciOiJIUzI1NiJ9.eyJzdWIiOiJ1c2VyLXV1aWQi...(15min)",
  "refresh_token": "9f2b8c1a7e4d6f0b3c5a8e1d2f4b6c9a0e3d5f7b...(30d)",
  "user": {
    "id": "usr_7NpXqRmL",
    "email": "fulano@example.com",
    "fullName": "Fulano da Silva",
    "username": "fulaninho"
  },
  "request_id": "req_2mKpXvRq",
  "timestamp": "2026-06-17T14:30:00.000Z"
}

curl -X POST https://api.laranja.site/api/v2/auth/refresh \
  -H "Content-Type: application/json" \
  -d '{
    "refresh_token": "9f2b8c1a7e4d6f0b3c5a8e1d2f4b6c9a0e3d5f7b..."
  }'

# 200 OK
{
  "success": true,
  "access_token": "eyJhbGciOiJIUzI1NiJ9.eyJzdWIiOiJ1c2VyLXV1aWQi...(new, 15min)",
  "refresh_token": "a1c3e5f7b9d1c3e5f7b9d1c3e5f7b9d1...(new, 30d)",
  "request_id": "req_5qLmXpVr",
  "timestamp": "2026-06-17T14:45:00.000Z"
}

curl -X POST https://api.laranja.site/api/v2/auth/logout \
  -H "Content-Type: application/json" \
  -d '{
    "refresh_token": "9f2b8c1a7e4d6f0b3c5a8e1d2f4b6c9a0e3d5f7b..."
  }'

# 200 OK
{
  "success": true,
  "message": "logout realizado",
  "request_id": "req_9vNpKqXm",
  "timestamp": "2026-06-17T15:00:00.000Z"
}

curl -X GET https://api.laranja.site/api/v2/balance \
  -H "Authorization: Bearer sk_live_•••"

# 200 OK
{
  "success": true,
  "data": {
    "available": 1250.00,
    "pending": 320.00,
    "currency": "BRL",
    "wallets": {
      "principal": { "label": "PIX Principal", "available": 950.00 },
      "secundaria": { "label": "PIX Plus", "available": 300.00 }
    }
  },
  "request_id": "req_8xK2mNpQ",
  "timestamp": "2026-06-17T14:30:00.000Z"
}

curl -X GET https://api.laranja.site/api/v2/profile \
  -H "Authorization: Bearer sk_live_•••"

# 200 OK
{
  "success": true,
  "data": {
    "name": "João Silva",
    "document": "***.456.789-**",
    "email": "joao@exemplo.com.br",
    "status": "active",
    "kyc_status": "approved"
  },
  "request_id": "req_3pLxNrQv",
  "timestamp": "2026-06-17T14:30:00.000Z"
}

curl -X POST https://api.laranja.site/api/v2/transactions/cashin \
  -H "Authorization: Bearer sk_live_•••" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": 250.00,
    "external_id": "pedido_1042",
    "description": "Pedido #1042 — Loja ABC",
    "wallet": "secundaria",
    "webhook_url": "https://sualoja.com/webhooks/laranjapay"
  }'

# 200 OK
{
  "success": true,
  "transaction_id": "txn_9Km3xPqR",
  "external_id": "pedido_1042",
  "amount": 250.00,
  "fee": 2.49,
  "currency": "BRL",
  "payment_method": "pix",
  "payment_info": {
    "qrcode": "00020126580014br.gov.bcb.pix...",
    "expiration": 3600,
    "expires_at": "2026-06-17T15:30:00.000Z"
  },
  "status": "pending_payment",
  "wallet": "secundaria",
  "postback_url": "https://sualoja.com/webhooks/laranjapay",
  "created_at": "2026-06-17T14:30:00.000Z"
}

TIMESTAMP=$(date +%s)
NONCE=$(uuidgen)
PAYLOAD='{"external_id":"saque_001","amount":50.00,"key":"joao@email.com","key_type":"email","name":"João Silva","wallet":"principal"}'
SIG=$(echo -n "${TIMESTAMP}.${NONCE}.${PAYLOAD}" | \
  openssl dgst -sha256 -hmac "$SIGNING_KEY" -hex | awk '{print $2}')

curl -X POST https://api.laranja.site/api/v2/transactions/cashout \
  -H "Authorization: Bearer sk_live_•••" \
  -H "Content-Type: application/json" \
  -H "X-Signature: $SIG" \
  -H "X-Timestamp: $TIMESTAMP" \
  -H "X-Nonce: $NONCE" \
  -d '$PAYLOAD'

# 202 Accepted
{
  "transaction_id": "txn_7NpXqRmL",
  "external_id": "saque_001",
  "amount": 50.00,
  "fee": 1.99,
  "currency": "BRL",
  "status": "processing",
  "wallet": "principal",
  "created_at": "2026-06-17T14:30:00.000Z"
}

curl -X POST https://api.laranja.site/api/v2/account/transactions/list \
  -H "Authorization: Bearer sk_live_•••" \
  -H "Content-Type: application/json" \
  -d '{
    "page": 1,
    "page_size": 10,
    "type": "cashin",
    "status": "confirmed",
    "from_date": "2026-06-01"
  }'

# 200 OK
{
  "success": true,
  "data": [
    {
      "id": "txn_9Km3xPqR",
      "type": "cashin",
      "amount": 250.00,
      "fee": 2.49,
      "status": "confirmed",
      "external_id": "pedido_1042",
      "created_at": "2026-06-17T14:30:00.000Z"
    }
  ],
  "pagination": {
    "page": 1,
    "page_size": 10,
    "total": 47,
    "total_pages": 5
  }
}

{
  "event": "cashin.confirmed",
  "transaction_id": "txn_9Km3xPqR",
  "external_id": "pedido_1042",
  "amount": 250.00,
  "fee": 2.49,
  "net": 247.51,
  "currency": "BRL",
  "status": "confirmed",
  "confirmed_at": "2026-06-17T14:35:12.000Z"
}

{
  "success": false,
  "error": {
    "code": "INSUFFICIENT_FUNDS",
    "message": "Saldo insuficiente para realizar o saque."
  },
  "request_id": "req_4xVpQnRm"
}