Voltar para o Portal

Guia de Integração Completa - APIs GetNet

Este guia apresenta um fluxo completo de integração com as APIs GetNet, desde a autenticação até a criação de um pedido com merchant pessoa física.

🔄 Fluxo de Integração Completa

1. Autenticação → 2. Consultar Ofertas → 3. Cadastrar Merchant PF → 4. Qualificar Merchant → 5. Criar Pedido
Ambiente de Teste: Todos os exemplos utilizam o ambiente de sandbox. Para produção, substitua as URLs por:
https://api-backoffice.getnet.com.br
1

Autenticação OAuth 2.0

Primeiro passo é obter o token de acesso para autenticar as próximas chamadas.

POST /auth/token
POST https://api-homologacao.getnet.com.br/auth/token Content-Type: application/json { "client_id": "seu_client_id_aqui", "client_secret": "seu_client_secret_aqui", "grant_type": "client_credentials" }

Resposta:

{ "access_token": "eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9...", "token_type": "Bearer", "expires_in": 3600 }
Importante: Armazene o token de forma segura e implemente renovação automática antes do vencimento.
2

Consultar Ofertas na Vitrine

Consulte as ofertas disponíveis para o canal e país especificados, incluindo informações dos adquirentes.

GET /v1/offerings?channel=getnet_ecommerce&country=BR&show_acquirers=true
GET https://api-homologacao.getnet.com.br/v1/offerings?channel=getnet_ecommerce&country=BR&show_acquirers=true Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9... Content-Type: application/json

Resposta (resumida):

{ "offerings": [ { "offering_id": "507f1f77bcf86cd799439011", "priced_offering_id": "507f191e810c19729de860ea", "name": "Pacote E-commerce Básico", "description": "Ideal para pequenos negócios online", "channel": "ECOMMERCE", "country": "BR", "pricing": { "setup_fee": 0.00, "monthly_fee": 29.90, "transaction_fee": "2.99%" }, "acquirers": [ { "acquirer_id": "getnet", "name": "GetNet", "fees": { "credit_card": "2.99%", "debit_card": "1.99%" } } ], "features": ["PIX", "Cartão de Crédito", "Cartão de Débito"] } ] }
Dica: Guarde o priced_offering_id da oferta escolhida, será necessário no passo 5.
3

Cadastrar Merchant Pessoa Física

Cadastre um novo estabelecimento comercial pessoa física com os dados completos.

POST /v1/merchants
POST https://api-homologacao.getnet.com.br/v1/merchants Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9... Content-Type: application/json { "personal_data": { "first_name": "João", "last_name": "Silva", "cpf": "12345678901", "birth_date": "1985-03-15", "phone": { "country_code": "55", "area_code": "11", "number": "987654321" }, "email": "joao.silva@email.com" }, "business_data": { "business_name": "João Silva ME", "cnpj": "12345678000195", "mcc": "5999", "business_address": { "street": "Rua das Flores", "number": "123", "neighborhood": "Centro", "city": "São Paulo", "state": "SP", "postal_code": "01234567", "country": "BR" } }, "bank_account": { "bank": "001", "agency": "1234", "account": "567890", "account_type": "CHECKING" } }

Resposta:

{ "merchant_id": "507f1f77bcf86cd799439012", "status": "PENDING_QUALIFICATION", "created_at": "2025-09-11T10:30:00Z", "personal_data": { "first_name": "João", "last_name": "Silva", "cpf": "123.456.789-01" }, "business_data": { "business_name": "João Silva ME", "cnpj": "12.345.678/0001-95" } }
Sucesso: Merchant criado com ID: 507f1f77bcf86cd799439012. Status: Pendente de qualificação.
4

Qualificar Merchant

Execute a qualificação do merchant para habilitar o processamento de transações.

POST /v1/merchants/{merchant_id}/qualification
POST https://api-homologacao.getnet.com.br/v1/merchants/507f1f77bcf86cd799439012/qualification Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9... Content-Type: application/json { "qualification_data": { "monthly_revenue": 50000.00, "business_type": "ONLINE_STORE", "website_url": "https://loja.joaosilva.com.br", "business_description": "Loja online de produtos eletrônicos" }, "documentation": { "cpf_document": "base64_encoded_document", "cnpj_document": "base64_encoded_document", "bank_statement": "base64_encoded_document" } }

Resposta:

{ "qualification_id": "507f1f77bcf86cd799439013", "merchant_id": "507f1f77bcf86cd799439012", "status": "APPROVED", "approved_at": "2025-09-11T10:45:00Z", "risk_analysis": { "score": 850, "level": "LOW_RISK" }, "processing_capabilities": { "max_transaction_amount": 10000.00, "daily_limit": 100000.00 } }
Aprovado: Merchant qualificado com sucesso! Agora pode processar transações.
5

Criar Pedido

Finalize o processo criando um pedido associando o merchant qualificado à oferta escolhida.

POST /v1/orders
POST https://api-homologacao.getnet.com.br/v1/orders Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9... Content-Type: application/json { "merchant_id": "507f1f77bcf86cd799439012", "priced_offering_id": "507f191e810c19729de860ea", "order_data": { "amount": 15000.00, "currency": "BRL", "description": "Adesão ao Pacote E-commerce Básico", "external_order_id": "ORDER_2025_001" }, "payment_method": { "type": "CREDIT_CARD", "installments": 1 }, "customer": { "name": "João Silva", "email": "joao.silva@email.com", "document": "12345678901" } }

Resposta:

{ "order_id": "507f1f77bcf86cd799439014", "merchant_id": "507f1f77bcf86cd799439012", "offering_id": "507f1f77bcf86cd799439011", "priced_offering_id": "507f191e810c19729de860ea", "status": "CONFIRMED", "amount": 15000.00, "currency": "BRL", "created_at": "2025-09-11T11:00:00Z", "payment_details": { "payment_id": "507f1f77bcf86cd799439015", "status": "APPROVED", "transaction_id": "507f1f77bcf86cd799439016" }, "activation": { "estimated_date": "2025-09-12T00:00:00Z", "status": "SCHEDULED" } }
Integração Completa! Pedido criado com sucesso!
Próximos Passos:
Segurança:

Documentação Adicional

Para mais detalhes sobre cada API, consulte a documentação específica: