Criar Transação

POST

/transactions

Cria uma nova transação (PIX, cartão de crédito ou boleto).

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/json

Examples

PIXCartão de Crédito Visa (Tokenizado)Cartão de Crédito

{
    "customer": {
        "name": "João da Silva",
        "email": "joao.silva@example.com",
        "phone": "11987654321",
        "document": {
            "number": "01234567890",
            "type": "CPF"
        }
    },
    "shipping": {
        "address": {
            "street": "Rua das Flores",
            "streetNumber": "123",
            "complement": "Apartamento 101",
            "zipCode": "12345-678",
            "neighborhood": "Centro",
            "city": "São Paulo",
            "state": "SP",
            "country": "BR"
        }
    },
    "paymentMethod": "PIX",
    "pix": {
        "expiresInDays": 1
    },
    "items": [
        {
            "title": "Produto 01",
            "unitPrice": 500,
            "quantity": 1,
            "externalRef": "PRODUTO0001"
        },
        {
            "title": "Produto 02",
            "unitPrice": 500,
            "quantity": 1,
            "externalRef": "PRODUTO0002"
        }
    ],
    "amount": 1000,
    "postbackUrl": "https://webhook.site/xxxxx",
    "metadata": "{\"info\":\"dados extras\"}",
    "ip": "213.123.123.13",
    "description": "Compra de teste"
}

Códigos de solicitação

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

cURL

PIXCartão de Crédito Visa (Tokenizado)Cartão de Crédito

curl --location --request POST 'https://api.huntersub.com.br/functions/v1/transactions' \
--header 'Authorization: Basic <encoded-value>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "customer": {
        "name": "João da Silva",
        "email": "joao.silva@example.com",
        "phone": "11987654321",
        "document": {
            "number": "01234567890",
            "type": "CPF"
        }
    },
    "shipping": {
        "address": {
            "street": "Rua das Flores",
            "streetNumber": "123",
            "complement": "Apartamento 101",
            "zipCode": "12345-678",
            "neighborhood": "Centro",
            "city": "São Paulo",
            "state": "SP",
            "country": "BR"
        }
    },
    "paymentMethod": "PIX",
    "pix": {
        "expiresInDays": 1
    },
    "items": [
        {
            "title": "Produto 01",
            "unitPrice": 500,
            "quantity": 1,
            "externalRef": "PRODUTO0001"
        },
        {
            "title": "Produto 02",
            "unitPrice": 500,
            "quantity": 1,
            "externalRef": "PRODUTO0002"
        }
    ],
    "amount": 1000,
    "postbackUrl": "https://webhook.site/xxxxx",
    "metadata": "{\"info\":\"dados extras\"}",
    "ip": "213.123.123.13",
    "description": "Compra de teste"
}'

Respostas

🟢200OK

application/json

Transação criada com sucesso.

Body

Examples

Sucesso PIXSucesso CARDSucesso

{
    "id": "e15441f7-f826-4858-8bc1-5b46940a4c52",
    "amount": 500,
    "refundedAmount": 0,
    "companyId": "2a5578e4-a8bf-4be7-be03-c36d2bedece6",
    "installments": 1,
    "paymentMethod": "PIX",
    "status": "waiting_payment",
    "postbackUrl": "https://webhook.site/xxxxx",
    "metadata": "{\"info\":\"dados extras\"}",
    "traceable": false,
    "createdAt": "2025-03-08T12:52:03+00:00",
    "updatedAt": "2025-03-08T12:52:03+00:00",
    "paidAt": null,
    "ip": "213.123.123.13",
    "externalRef": null,
    "customer": {
        "id": "7db6d766-71d4-4ae9-9122-3d4464c8b505",
        "name": "João Silva",
        "email": "joao.silva@example.com",
        "phone": "11987654321",
        "birthdate": null,
        "createdAt": "2025-03-08T15:52:03.292755",
        "document": {
            "number": "01234567890",
            "type": "CPF"
        },
        "address": {
            "street": "Rua das Flores",
            "streetNumber": "123",
            "complement": "Apartamento 101",
            "zipCode": "12345678",
            "neighborhood": "Centro",
            "city": "São Paulo",
            "state": "SP",
            "country": "BR"
        }
    },
    "card": null,
    "boleto": null,
    "pix": {
        "qrcode": "00020101021226910014br.gov.bcb.pix2569qrcode.pix.celcoin.com.br/pixqrcode/v2/55d5716e13f7f9b849a661362e87b55204000053039865802BR5923OTAVIO COSTA CASAGRANDE6007CACADOR62070503***63044669",
        "expirationDate": "2025-03-08T13:12:03+00:00",
        "end2EndId": null,
        "receiptUrl": null
    },
    "shipping": {
        "street": "Rua das Flores",
        "streetNumber": "123",
        "complement": "Apartamento 101",
        "zipCode": "12345-678",
        "neighborhood": "Centro",
        "city": "São Paulo",
        "state": "SP",
        "country": "BR"
    },
    "refusedReason": null,
    "items": [
        {
            "title": "Produto 01",
            "quantity": 1
        }
    ],
    "splits": [
        {
            "recipientId": "b0e8766d-dc89-4b93-a364-f44769651ee9",
            "netAmount": 290
        }
    ],
    "fee": {
        "fixedAmount": 2,
        "spreadPercentage": 1.99,
        "estimatedFee": 210,
        "netAmount": 290
    }
}

🔴500Erro do servidor

Modificado em 2025-03-11 15:38:45