onny

POST/payments/v1/charges

Exige X-Onny-Api-Key com uma chave de API do projeto.

curl -X POST "https://api.onny.space/payments/v1/charges" \
  -H "X-Onny-Api-Key: $ONNY_API_KEY" \
  -H "Idempotency-Key: pedido-42" \
  -H "Content-Type: application/json" \
  -d '{"amountCents":1990,"description":"Primeiro projeto na onny.","payerEmail":"cliente@exemplo.com","externalReference":"pedido-42","expiresInMinutes":30}'

POSTapi.onny.space/payments/v1/charges

Chave de APIIdempotency-Key cabeçalho · stringRepetir a mesma chave devolve a mesma cobrança. Para uma cobrança nova, .Corpo application/json

{
  "amountCents": 1990,
  "description": "Primeiro projeto na onny.",
  "payerEmail": "cliente@exemplo.com",
  "externalReference": "pedido-42",
  "expiresInMinutes": 30
}

Envie a requisição para ver status, tempo e corpo da resposta.

Corpo da requisição application/json

amountCentsinteger
Valor em centavos (mínimo R$ 1,00).
descriptionstringobrigatório
O que está sendo pago (aparece para o pagador).
máx. 140
payerEmailstring | null
E-mail do pagador (opcional; o Mercado Pago pede um e-mail).
máx. 256
externalReferencestring | null
Sua referência (pedido, fatura…). Volta nos webhooks.
máx. 100
expiresInMinutesinteger | null
Validade do Pix em minutos (30 a 1440, padrão 30). O Mercado Pago exige pelo menos 30.

Respostas

200OK

{
  "id": "01923f4e-7b1a-7c3d-9e2f-5a6b7c8d9e0f",
  "status": "pending",
  "amountCents": 1990,
  "currency": "BRL",
  "description": "Primeiro projeto na onny.",
  "externalReference": "pedido-42",
  "pixCode": "texto",
  "pixQrBase64": "texto",
  "payUrl": "texto",
  "mode": "live",
  "expiresAt": "2026-10-11T12:00:00+00:00",
  "paidAt": "2026-10-11T12:00:00+00:00",
  "createdAt": "2026-10-11T12:00:00+00:00",
  "failureReason": "texto"
}

14 campos descrição de cada um

iduuid
Id da cobrança.
statusstring
creating, pending, paid, expired, canceled, refunded ou failed.
amountCentsinteger
Valor em centavos.
currencystring
Moeda (BRL).
descriptionstring
Descrição.
externalReferencestring | null
Sua referência.
pixCodestring | null
Pix copia-e-cola.
pixQrBase64string | null
QR Code (PNG em base64).
payUrlstring
Página de pagamento da onny para enviar ao pagador.
modestring
live ou test.
expiresAtdatetime
Vence em.
paidAtdatetime | null
Paga em.
createdAtdatetime
Criada em.
failureReasonstring | null
Motivo da falha, se houver.

201Created

{
  "id": "01923f4e-7b1a-7c3d-9e2f-5a6b7c8d9e0f",
  "status": "pending",
  "amountCents": 1990,
  "currency": "BRL",
  "description": "Primeiro projeto na onny.",
  "externalReference": "pedido-42",
  "pixCode": "texto",
  "pixQrBase64": "texto",
  "payUrl": "texto",
  "mode": "live",
  "expiresAt": "2026-10-11T12:00:00+00:00",
  "paidAt": "2026-10-11T12:00:00+00:00",
  "createdAt": "2026-10-11T12:00:00+00:00",
  "failureReason": "texto"
}

14 campos descrição de cada um

iduuid
Id da cobrança.
statusstring
creating, pending, paid, expired, canceled, refunded ou failed.
amountCentsinteger
Valor em centavos.
currencystring
Moeda (BRL).
descriptionstring
Descrição.
externalReferencestring | null
Sua referência.
pixCodestring | null
Pix copia-e-cola.
pixQrBase64string | null
QR Code (PNG em base64).
payUrlstring
Página de pagamento da onny para enviar ao pagador.
modestring
live ou test.
expiresAtdatetime
Vence em.
paidAtdatetime | null
Paga em.
createdAtdatetime
Criada em.
failureReasonstring | null
Motivo da falha, se houver.

400Bad Request

{
  "type": "https://tools.ietf.org/html/rfc9110",
  "title": "auth.invalid / validation",
  "status": 400,
  "detail": "Mensagem legível para pessoas.",
  "code": "auth.invalid / validation",
  "traceId": "00-4bf9…-01"
}

401Unauthorized

{
  "type": "https://tools.ietf.org/html/rfc9110",
  "title": "Unauthorized",
  "status": 401,
  "detail": "Mensagem legível para pessoas.",
  "code": "Unauthorized",
  "traceId": "00-4bf9…-01"
}

409Conflict

{
  "type": "https://tools.ietf.org/html/rfc9110",
  "title": "error",
  "status": 409,
  "detail": "Mensagem legível para pessoas.",
  "code": "error",
  "traceId": "00-4bf9…-01"
}

422Unprocessable Entity

{
  "type": "https://tools.ietf.org/html/rfc9110",
  "title": "error",
  "status": 422,
  "detail": "Mensagem legível para pessoas.",
  "code": "error",
  "traceId": "00-4bf9…-01"
}

503Service Unavailable

{
  "type": "https://tools.ietf.org/html/rfc9110",
  "title": "error",
  "status": 503,
  "detail": "Mensagem legível para pessoas.",
  "code": "error",
  "traceId": "00-4bf9…-01"
}

curl -X POST "https://api.onny.space/payments/v1/charges" \ -H "X-Onny-Api-Key: $ONNY_API_KEY" \ -H "Idempotency-Key: pedido-42" \ -H "Content-Type: application/json" \ -d '{"amountCents":1990,"description":"Primeiro projeto na onny.","payerEmail":"cliente@exemplo.com","externalReference":"pedido-42","expiresInMinutes":30}'

{ "id": "01923f4e-7b1a-7c3d-9e2f-5a6b7c8d9e0f", "status": "pending", "amountCents": 1990, "currency": "BRL", "description": "Primeiro projeto na onny.", "externalReference": "pedido-42", "pixCode": "texto", "pixQrBase64": "texto", "payUrl": "texto", "mode": "live", "expiresAt": "2026-10-11T12:00:00+00:00", "paidAt": "2026-10-11T12:00:00+00:00", "createdAt": "2026-10-11T12:00:00+00:00", "failureReason": "texto" }

{ "type": "https://tools.ietf.org/html/rfc9110", "title": "auth.invalid / validation", "status": 400, "detail": "Mensagem legível para pessoas.", "code": "auth.invalid / validation", "traceId": "00-4bf9…-01" }

Criar cobrança Pix

Corpo da requisição application/json

Respostas

Criar cobrança Pix

Corpo da requisição application/json

Respostas