Criar nova transação

POST

/transactions

Cria uma nova transação de pagamento PIX.

Requisição

Authorization

Envie suas requisições HTTP com um cabeçalho

Authorization

que contenha a palavra Basic seguida por um espaço e uma string codificada em base64 username:password

Exemplo:

Authorization: Basic *****************

Parâmetros Bodyapplication/jsonNecessário

Examples

Respostas

🟢201Criado

application/json

Transação criada com sucesso

Body

🟠400Solicitação incorreta

🟠401Não autenticado

🔴500Erro interno do servidor

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://api.fullpix.com.br/functions/v1/transactions' \
--header 'Authorization: Basic <encoded-value>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "paymentMethod": "PIX",
    "amount": 10000,
    "customer": {
        "name": "João Silva",
        "email": "joao@example.com",
        "phone": "11987654321",
        "document": {
            "number": "12345678901",
            "type": "CPF"
        }
    },
    "shipping": {
        "address": {
            "street": "Rua teste",
            "streetNumber": "2099",
            "zipCode": "23822181",
            "neighborhood": "Centro",
            "complement": "Lt19 Qd 134",
            "city": "Aracaju",
            "state": "SE",
            "country": "BR"
        }
    },
    "items": [
        {
            "title": "Produto Digital",
            "unitPrice": 10000,
            "quantity": 1,
            "tangible": false
        }
    ],
    "postbackUrl": "https://example.com/webhook",
    "metadata": {
        "order_id": "ORD-12345",
        "cli_id": "CLI-12345"
    }
}'

Response Example

201 - Resposta PIX criado

{
    "id": "txn_abc123def456",
    "amount": 10000,
    "paidAmount": 0,
    "refundedAmount": 0,
    "companyId": "123e4567-e89b-12d3-a456-426614174000",
    "installments": 1,
    "paymentMethod": "PIX",
    "status": "waiting_payment",
    "postbackUrl": "https://example.com/webhook",
    "metadata": {
        "order_id": "ORD-12345"
    },
    "traceable": false,
    "secureId": "sec_xyz789",
    "createdAt": "2025-01-06T10:00:00Z",
    "updatedAt": "2025-01-06T10:00:00Z",
    "paidAt": null,
    "ip": "192.168.1.1",
    "externalRef": null,
    "authorizationCode": null,
    "basePrice": 10000,
    "interestRate": 0,
    "origin": "api",
    "customer": {
        "id": "cus_123456",
        "name": "João Silva",
        "email": "joao@example.com",
        "phone": "11987654321",
        "birthdate": null,
        "createdAt": "2025-01-06T10:00:00Z",
        "document": {
            "number": "12345678901",
            "type": "CPF"
        },
        "address": {
            "street": "Rua das Flores",
            "streetNumber": "123",
            "complement": "Apto 45",
            "zipCode": "01234567",
            "neighborhood": "Centro",
            "city": "São Paulo",
            "state": "SP",
            "country": "BR"
        }
    },
    "card": null,
    "boleto": null,
    "pix": {
        "qrcode": "00020126580014br.gov.bcb.pix...",
        "expirationDate": "2025-01-06T11:00:00Z",
        "end2EndId": null,
        "receiptUrl": null
    },
    "shipping": {
        "street": "Rua das Flores",
        "streetNumber": "123",
        "complement": "Apto 45",
        "zipCode": "01234567",
        "neighborhood": "Centro",
        "city": "São Paulo",
        "state": "SP",
        "country": "BR"
    },
    "refusedReason": null,
    "items": [
        {
            "externalRef": null,
            "title": "Produto Digital",
            "unitPrice": 10000,
            "quantity": 1,
            "tangible": false
        }
    ],
    "splits": [],
    "refunds": [],
    "delivery": {
        "status": null,
        "trackingCode": null
    },
    "fee": {
        "fixedAmount": 50,
        "spreadPercentage": 2.5,
        "estimatedFee": 300,
        "netAmount": 9700
    },
    "fingerPrint": null,
    "paymentlink_id": null
}

Modificado em 2025-11-07 04:19:33

Página anterior

Estornar transação

Próxima página

Obter detalhes de uma transação