---
title: "Request credit paid by Pix: multipart with `usd`, `comprovante` (photo or PDF up to 2 MB) and `email`; the rest is optional."
method: POST
path: "/api/credito/pix"
---

# Request credit paid by Pix: multipart with \`usd\`, \`comprovante\` (photo or PDF up to 2 MB) and \`email\`; the rest is optional.

`POST /api/credito/pix`

## Request

- Base URL: `https://okfindex.com`
- URL: `https://okfindex.com/api/credito/pix`
- Auth: none declared

The credit code comes back in the response and works once the owner checks the Pix and releases it (by hand, usually the same day). `email` is required: it is how the owner reaches the person. Optional: `nome`, `pagina` (the page the request came from, up to 2,000 characters) and what the person was buying when the 402 came — `recurso` (up to 2,000), `descricao` (up to 300) and `preco_usd` (decimal, e.g. `0.50`); and `navegador_id` (a UUID that links the requests from the same browser). Everything that arrives is recorded with the request — the receipt included —, with the signed-in account (checked by the session cookie), the network and browser.
Returns: { id, estado, credito, estado_em }

## Response `200`

{ id, estado, credito, estado_em }

- object
  - `id` string, required: Request id, to follow it.
  - `estado` string, required: `pendente` until the decision.
  - `credito` string, required: The `cred_…` token, shown ONCE; it works after the release.
  - `estado_em` string, required: Where to follow the request.

## Other responses

- `400`: Pack outside the list (3, 5, 10 or 25), no receipt or no valid e-mail.
- `413`: Receipt above 2 MB.
- `415`: Receipt that is neither a photo (JPEG, PNG, WebP) nor a PDF.
- `429`: This network already sent today's requests.
- `502`: The e-mail to the owner did not go out: the request is recorded as `falhou`; send it again.
- `503`: Review queue full, or Pix not available in this app.

---

[API](https://skmtc.dev/okfindex/apis/okf-index.md) · [All operations](https://skmtc.dev/okfindex/apis/okf-index/llms.txt) · [OpenAPI document](https://skmtc.dev/okfindex/apis/okf-index/revisions/4b13ca3c739f?raw)