Criar pagamento Pix por conta

curl --request POST \
  --url https://gateway.staging.azentech.dev/api/pix/manual_pay \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "merchant_transaction_id": "50000000-0000-4000-8000-000000000004",
  "amount": 75.25,
  "document_number": "12345678909",
  "branch_code": "0001",
  "account_number": "123456-7",
  "ispb": "12345678",
  "account_type": "CACC"
}
'

import requests

url = "https://gateway.staging.azentech.dev/api/pix/manual_pay"

payload = {
    "merchant_transaction_id": "50000000-0000-4000-8000-000000000004",
    "amount": 75.25,
    "document_number": "12345678909",
    "branch_code": "0001",
    "account_number": "123456-7",
    "ispb": "12345678",
    "account_type": "CACC"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    merchant_transaction_id: '50000000-0000-4000-8000-000000000004',
    amount: 75.25,
    document_number: '12345678909',
    branch_code: '0001',
    account_number: '123456-7',
    ispb: '12345678',
    account_type: 'CACC'
  })
};

fetch('https://gateway.staging.azentech.dev/api/pix/manual_pay', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "transaction": {
    "id": "10000000-0000-4000-8000-000000000001",
    "merchant_id": "20000000-0000-4000-8000-000000000001",
    "user_id": "30000000-0000-4000-8000-000000000001",
    "processor_id": "40000000-0000-4000-8000-000000000001",
    "merchant_transaction_id": "50000000-0000-4000-8000-000000000004",
    "transaction_type": "pix",
    "first_name": null,
    "last_name": null,
    "email": null,
    "updated_at": "2026-10-23T14:30:00+00:00",
    "created_at": "2026-10-23T14:30:00+00:00",
    "events": [
      {
        "id": "60000000-0000-4000-8000-000000000001",
        "success": true,
        "status": "pending_settlement",
        "event_type": "payment",
        "amount": "75.25",
        "ip_address": null,
        "processor_code": null,
        "processor_message": null,
        "processor_transaction_id": "sandbox-event-1001",
        "batch_id": null,
        "qrcode": null,
        "qrcode_image": "",
        "pix_key_type": null,
        "pix_key_value": null,
        "pix_message": "Pagamento para: CONTA DEMO",
        "updated_at": "2026-10-23T14:30:00+00:00",
        "created_at": "2026-10-23T14:30:00+00:00"
      }
    ],
    "document_number": "12345678909",
    "status": "pending",
    "flow_type": "cashout",
    "error": null,
    "e2e_id": null,
    "source": "player",
    "tag": null
  }
}

POST

api

pix

manual_pay

Criar pagamento Pix por conta

curl --request POST \
  --url https://gateway.staging.azentech.dev/api/pix/manual_pay \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "merchant_transaction_id": "50000000-0000-4000-8000-000000000004",
  "amount": 75.25,
  "document_number": "12345678909",
  "branch_code": "0001",
  "account_number": "123456-7",
  "ispb": "12345678",
  "account_type": "CACC"
}
'

import requests

url = "https://gateway.staging.azentech.dev/api/pix/manual_pay"

payload = {
    "merchant_transaction_id": "50000000-0000-4000-8000-000000000004",
    "amount": 75.25,
    "document_number": "12345678909",
    "branch_code": "0001",
    "account_number": "123456-7",
    "ispb": "12345678",
    "account_type": "CACC"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    merchant_transaction_id: '50000000-0000-4000-8000-000000000004',
    amount: 75.25,
    document_number: '12345678909',
    branch_code: '0001',
    account_number: '123456-7',
    ispb: '12345678',
    account_type: 'CACC'
  })
};

fetch('https://gateway.staging.azentech.dev/api/pix/manual_pay', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "transaction": {
    "id": "10000000-0000-4000-8000-000000000001",
    "merchant_id": "20000000-0000-4000-8000-000000000001",
    "user_id": "30000000-0000-4000-8000-000000000001",
    "processor_id": "40000000-0000-4000-8000-000000000001",
    "merchant_transaction_id": "50000000-0000-4000-8000-000000000004",
    "transaction_type": "pix",
    "first_name": null,
    "last_name": null,
    "email": null,
    "updated_at": "2026-10-23T14:30:00+00:00",
    "created_at": "2026-10-23T14:30:00+00:00",
    "events": [
      {
        "id": "60000000-0000-4000-8000-000000000001",
        "success": true,
        "status": "pending_settlement",
        "event_type": "payment",
        "amount": "75.25",
        "ip_address": null,
        "processor_code": null,
        "processor_message": null,
        "processor_transaction_id": "sandbox-event-1001",
        "batch_id": null,
        "qrcode": null,
        "qrcode_image": "",
        "pix_key_type": null,
        "pix_key_value": null,
        "pix_message": "Pagamento para: CONTA DEMO",
        "updated_at": "2026-10-23T14:30:00+00:00",
        "created_at": "2026-10-23T14:30:00+00:00"
      }
    ],
    "document_number": "12345678909",
    "status": "pending",
    "flow_type": "cashout",
    "error": null,
    "e2e_id": null,
    "source": "player",
    "tag": null
  }
}

Comportamento observado

O Gateway define pix_type como Manual. Não envie esse campo.
first_name e last_name não são exigidos por esta validação. email é opcional.
O validador torna document_number condicional, mas o fluxo de pagamento o lê sem fallback. Envie sempre um CPF ou CNPJ válido.
Se pix_message não for enviado, o Gateway usa Pagamento para: {alias do processador}.
Os limites mínimo e máximo do processador também são aplicados ao valor.
Para LBPay, repetir o mesmo merchant_transaction_id com a mesma intenção e o mesmo processador devolve a transação existente com HTTP 200 sem criar outra transferência no provedor. Se a intenção mudar, o Gateway devolve HTTP 409.
Nesse replay da LBPay, a rota volta a chamar o envio legado do webhook payment. Se a transação tiver origem player e houver uma inscrição, pode ocorrer um novo envio.
O código-fonte da rota contém um espaço final, mas o roteador registra e resolve /api/pix/manual_pay.

Os exemplos usam identificadores e credenciais sintéticos. Os resultados do processador dependem do credenciamento e da configuração do estabelecimento.

Authorizations

Authorization

string

header

required

Token de acesso fornecido para o estabelecimento.

Body

application/json

merchant_transaction_id

string

required

Identificador da transação no estabelecimento.

Maximum string length: 255

amount

number

required

Valor em reais, com no máximo duas casas decimais. Deve ser maior que zero e menor que 99.999.999 antes da aplicação dos limites do processador.

Must be a multiple of 0.01

document_number

string | null

required

CPF ou CNPJ. A obrigatoriedade depende da configuração do processador.

branch_code

string

required

Agência bancária.

Maximum string length: 255

account_number

string

required

Número da conta.

Maximum string length: 255

ispb

string

required

ISPB da instituição.

Maximum string length: 255

account_type

enum<string>

required

Tipo da conta.

Available options:

CACC,

SVGS,

SLRY,

TRAN

pix_message

string | null

Mensagem Pix. Máximo de 140 caracteres.

Maximum string length: 140

first_name

string | null

Nome opcional repassado ao pagamento manual Celcoin; a aceitação de valor vazio pelo processador não foi confirmada.

Maximum string length: 255

last_name

string | null

Sobrenome opcional repassado ao pagamento manual Celcoin; a aceitação de valor vazio pelo processador não foi confirmada.

Maximum string length: 255

string<email> | null

Email opcional.

Maximum string length: 255

processor_id

string<uuid> | null

UUID do processador. Na seleção comum, o Gateway usa o primeiro Pix habilitado por precedência; este campo só restringe a seleção quando source é settlement.

source

enum<string> | null

Origem da transação. Quando omitida em uma cobrança, o Gateway assume player.

Available options:

player,

settlement,

vendor,

funding,

internal,

balancing,

null

tag

string | null

Tag da transação. Conforme a configuração do estabelecimento, pode ser obrigatória, livre ou restrita a CPF ou CNPJ. Tags que contêm internal suprimem os webhooks de pagamento.

Maximum string length: 50

Response

Transação criada ou atualizada.

transaction

object

required

Show child attributes

Pix

Transações

Saldos

Relatórios

Sandbox

Webhooks

Criar pagamento Pix por conta

Comportamento observado

Authorizations

Body

Response

​Comportamento observado

Authorizations

Body

Response

Comportamento observado