Nosso endpoint de api

<https://api.realtechdev.com.br>

`POST` `/v1/transactions`

É necessário passar o header Authorization no formato “Bearer <token>” para realizar a chamada.

Nome	Obrigatório	Tipo	Descrição
external_id	Sim	String	Identificador externo
payment_method	Sim	String	O valor precisa ser “pix”
amount	Sim	Number	Valor em centavos
buyer	Não	Object
↳ name	Se o buyer for passado, Sim	String	Nome e Sobrenome separado por espaço
↳ email	Se o buyer for passado, sim	String	E-mail tradicional
↳ document	Não	String	CPF sem pontos nem hífens
↳ phone	Não	String	Telefone com 55 na frente, sem espaços ou hífens
tracking	Não		Objeto
↳ ref	Não	String ou null
↳ src	Não	String ou null
↳ sck	Não	String ou null
↳ utm_source	Não	String ou null
↳ utm_medium	Não	String ou null
↳ utm_campaign	Não	String ou null
↳ utm_id	Não	String ou null
↳ utm_term	Não	String ou null
↳ utm_content	Não	String ou null

Enviar duas requisições com o mesmo external_id gerará duas transações com o mesmo external_id, acarretando em erros na chamada GET /transactions/external_id.

Retorno:

Status 200

{
  "data": {
    "id": "390b5525-4629-4463-a32a-e0cd432d939b",
    "status": "pending",
    "payment_method": "pix",
    "pix": {
      "code": "00020126870014br.gov.bcb.pix2565pix.primepag.com.br/qr/v3/at/15ec9e9a-a486-407c-85a3-f912d18d4b7b5204000053039865802BR5922REAL_TECH_DIGITAL_LTDA6009SAO_PAULO62070503***63045341",
      "qrcode_base64": "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"
    },
    "total_amount": 3590,
    "net_amount": 3195.959,
    "created_at": "2025-05-24T17:45:19.084Z"
  }
}

Gerar um qrcode baseado no pix.code funciona

Erros de validação serão retornados com status 400 no seguinte formato:

{
  "error": {
    "message": "Invalid request body.",
    "detail": {
      "payment_method": [
        "O campo 'payment_method' é obrigatório."
      ],
      "amount": [
        "O campo 'amount' precisa ser um número."
      ]
    }
  }
}

Erros de autenticação serão retornados com status 401

{
  "error": {
    "message": "Unauthorized.",
    "detail": "Invalid authorization token."
  }
}

Erros ao chamar a adquirente ou erros inesperados serão retornados com status 500

POST /v1/transactions

`POST` `/v1/transactions`