API

Un POST. Un pago.

REST, JSON, autenticación por API Key. Sandbox disponible sin aprobación previa.

Hablar con un especialista Documentación

Autenticación

Toda solicitud usa una API Key en el header Authorization: Bearer — sk_test_... en sandbox, sk_live_... en producción.

bash

curl https://api.tamino.com.br/v1/payments \
  -H "Authorization: Bearer sk_test_..." \
  -H "Content-Type: application/json"

Crear pago

Un pago nace como pending y cambia de estado a medida que el proveedor confirma.

Request

POST /v1/payments

{
  "amount": 15000,
  "currency": "BRL",
  "method": "pix"
}

Response

200 OK

{
  "id": "pay_xxxxxxxxx",
  "status": "pending"
}

Consultar pago

El mismo recurso, consultado en cualquier momento por su id.

json

GET /v1/payments/pay_xxxxxxxxx

{
  "id": "pay_xxxxxxxxx",
  "status": "approved",
  "amount": 15000,
  "currency": "BRL",
  "method": "pix"
}

Idempotencia

Envía Idempotency-Key en cualquier solicitud mutable — reenviar con la misma clave devuelve la respuesta ya calculada, nunca duplica la operación.

bash

curl -X POST https://api.tamino.com.br/v1/payments \
  -H "Authorization: Bearer sk_test_..." \
  -H "Idempotency-Key: 8f14e45f-ceea-..." \
  -d '{ "amount": 15000, "currency": "BRL", "method": "pix" }'

Errores

Todo error sigue el mismo envoltorio, con un correlationId para rastrear con soporte.

json

{
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "amount must be a positive integer.",
    "correlationId": "c7a1..."
  }
}