> For the complete documentation index, see [llms.txt](https://docs.4p.finance/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.4p.finance/on-ramp/criando-uma-transacao.md).

# Criando uma transação

### Serviço

• Envia um JSON contendo os dados necessários para a criação de uma cobrança imediata.

• Retorna um JSON contendo os dados da cobrança criada, inclusive Pix Copia-e-Cola.

### Solicitação de registro/transação

A requisição para realizar a criação/registro de uma transação deverá ter como corpo da solicitação JSON as informações necessárias para registrar a transação.

### Exemplo de payload

```json
{
  "cpf": "01234567899", // Troque esta chave para "cnpj" no caso de CNPJ / Pessoa Jurídica.
  "email": "usuario@example.com",
  "amount": 1.10,
  "expires": 3600,
  "custom_id": "PN123",
  "custom_data": {
    "chain": "Arbitrum", // Opcional (Default: Arbitrum)
    "asset": "USDT", // // Opcional (Default: USDT)
    "receiver_wallet": "0x4328...edFB995B6I"
  },
  "description": "Cobrança de assinatura #PN123",
  "notification_url": "https://seu-dominio-webhook.com.br/param=tes&token=abcd-dfg"
}
```

### Requisição

## Solicita a criação/registro de uma transação.

<mark style="color:green;">`PUT`</mark> `https://api.4p.finance/v1/pix/transaction`

Realiza a solicitação do registro de uma transação.

#### Headers

| Name                                        | Type   | Description    |
| ------------------------------------------- | ------ | -------------- |
| x-api-key<mark style="color:red;">\*</mark> | String | Sua chave API. |

#### Request Body

<table><thead><tr><th width="202.765625">Name</th><th width="129.25">Type</th><th>Description</th></tr></thead><tbody><tr><td>expires<mark style="color:red;">*</mark></td><td>Integer</td><td>T empo de vida da cobrança, em segundos, a partir da data de criação. Deve ser igual ou maior do que 300. Máximo: 259200 segundos.</td></tr><tr><td>amount<mark style="color:red;">*</mark></td><td>Number</td><td>Valor original da cobrança. Deve ser informado um valor maior ou igual a 0.01, com casas decimais.</td></tr><tr><td>custom_id <mark style="color:red;">*</mark></td><td>String</td><td>Id da transação ou Id do Pix. Permite que o usuário recebedor faça a conciliação dos pagamentos. Deve ser único por transação PIX e conter no máximo 255 caracteres.</td></tr><tr><td>description<mark style="color:red;">*</mark></td><td>String</td><td>Representa um texto ( campo solicitacaoPagador do PIX ), a ser apresentado ao usuário pagador para que ele possa digitar uma informação correlata, em formato livre, a ser enviada ao usuário recebedor. Máximo 140 caracteres.</td></tr><tr><td>notification_url <mark style="color:red;">*</mark></td><td>String</td><td>URL que receberá as notificações POST encaminhadas pelo serviço de webhook logo após o PIX ser pago.</td></tr><tr><td>custom_data<mark style="color:red;">*</mark></td><td>Object</td><td>Objeto pai para dados customizados.</td></tr><tr><td>receiver_wallet<mark style="color:red;">*</mark></td><td>String</td><td>Chave filha de <em>custom_data</em> para envio da carteira do cliente pagador do PIX, no qual receberá as criptomoedas. Usado para compras de criptomoedas através de API PIX para (P2P).</td></tr></tbody></table>

{% tabs %}
{% tab title="200: OK Retorno após criar/registrar uma transação." %}

```json
{
    "http_code": 200,
    "success": true,
    "info": {
        "result": "pix_transaction_created",
        "message": "The Pix transaction was successfully created.",
        "data": {
            "calendario": {
                "criacao": "2026-01-01T11:05:53.009Z",
                "expiracao": 3600
            },
            "devedor": {
                "cnpj": "00000000000000",
                "nome": ""
            },
            "valor": {
                "modalidadeAlteracao": 0,
                "original": 1.1
            },
            "chave": "4cf1bb22-71c1-4530-b735-d240c3c0f88a",
            "solicitacaoPagador": "Cobrança de assinatura #PN123",
            "infoAdicionais": [],
            "txid": "2ce3608c77264388b956c039",
            "location": "brcode.infra.com/v2/8657085674d44db288430cftb155ca62",
            "revisao": 0,
            "status": "ATIVA",
            "pixCopiaECola": "00010301021226190014br.gov.bcb.pix2557brcode.infra.com/v2/1652085674d33db965430cfab255ba405204000053039865802BR59254Pay Finance Prestadora d6106Recife62070503***6304F9E1",
            "code": 201
        }
    }
}
```

{% endtab %}
{% endtabs %}

### Retorno

Observe que o objeto *data* contém os dados do PIX incluindo chave Copia e Cola (pixCopiaECola). Ao criar uma cobrança Pix, o usuário recebedor obtém as informações para a geração da imagem do QR Code dinâmico, juntamente com sua representação em forma de Pix Copia-e-Cola.

Destacamos que a geração da imagem do QR Code não é gerada, e fica a cargo de cada implementador.

### Conclusão

Após a confirmação do pagamento, o valor convertido em criptomoeda será enviado automaticamente para a carteira informada no payload da requisição.

O tempo médio para envio e finalização da transação é de aproximadamente 10 segundos, podendo variar de acordo com a rede blockchain selecionada e as condições da própria rede no momento da operação.

Saiba mais sobre as notificações e callbacks na próxima sessão.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.4p.finance/on-ramp/criando-uma-transacao.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.