Primeros Pasos

Integre su aplicacion con la API de Owem Pay y realice su primera operacion PIX en pocos minutos.

1. Obtenga sus credenciales

Solicite al administrador de su cuenta Owem Pay:

• Client ID -- identificador de su API Key
• Client Secret -- clave secreta para autenticacion y firma HMAC

Seguridad

Nunca exponga el client_secret en codigo frontend o repositorios publicos. Utilice variables de entorno en su servidor.

2. Obtenga un token de acceso

Todas las solicitudes requieren un token Bearer. Genere un token con sus credenciales:

curl -X POST https://api.owem.com.br/api/v2/external/auth-token \
  -H "Content-Type: application/json" \
  -d '{
    "client_id": "su-api-key-id",
    "client_secret": "su-api-key-secret"
  }'

Respuesta:

{
  "worked": true,
  "access_token": "eyJhbGciOiJIUzUxMiIsInR5cCI6IkpXVCJ9...",
  "token_type": "Bearer",
  "expires_in": 3600
}

El token expira en 60 minutos. Implemente renovacion automatica antes de la expiracion.

3. Consulte el saldo

Pruebe la integracion consultando el saldo de la cuenta:

curl -X GET https://api.owem.com.br/api/v2/external/balance \
  -H "Authorization: Bearer $TOKEN"

Respuesta:

{
  "worked": true,
  "balance": 150000,
  "available": 150000,
  "pending": 0,
  "currency": "BRL"
}

Valores en centavos

Todos los valores monetarios son enteros en centavos. 150000 = R$ 1.500,00.

4. Genere un cobro PIX (Cash-In)

Cree un codigo QR para recibir un pago:

BODY='{"amount":10000,"description":"Pedido #1234"}'
HMAC=$(echo -n "$BODY" | openssl dgst -sha512 -hmac "$CLIENT_SECRET" | awk '{print $2}')

curl -X POST https://api.owem.com.br/api/v2/external/pix/cash-in \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -H "hmac: $HMAC" \
  -d "$BODY"

Respuesta:

{
  "worked": true,
  "transaction_id": "PIXIN20260307a1b2c3d4e5f6",
  "end_to_end_id": "E37839059202603071234000001",
  "qr_code": "00020126580014br.gov.bcb.pix...",
  "qr_code_image": "data:image/png;base64,...",
  "amount": 10000,
  "status": "pending"
}

Muestre el qr_code_image o el codigo copiar y pegar (qr_code) al pagador.

5. Consulte el estado

Realice el seguimiento del pago consultando por transaction_id:

curl -X GET https://api.owem.com.br/api/v2/external/transactions/PIXIN20260307a1b2c3d4e5f6 \
  -H "Authorization: Bearer $TOKEN"

Cuando el pago sea confirmado, el status cambia a completed.

6. Reciba notificaciones (Webhooks)

Para recibir notificaciones en tiempo real (recomendado en lugar de polling):

BODY='{"url":"https://susitio.com/webhook","events":["pix.received","pix.completed"]}'
HMAC=$(echo -n "$BODY" | openssl dgst -sha512 -hmac "$CLIENT_SECRET" | awk '{print $2}')

curl -X POST https://api.owem.com.br/api/v2/external/webhooks \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -H "hmac: $HMAC" \
  -d "$BODY"

Siguientes Pasos

• Autenticacion -- detalles del flujo de token
• HMAC-SHA512 -- como firmar solicitudes transaccionales
• PIX Cash-In -- generar cobros
• Estado de Cuenta -- consultar transacciones
• Webhooks -- notificaciones en tiempo real
• Conceptos -- valores, estados y claves PIX