Inovpay-API
  1. Transações
Inovpay-API
  • Comece Por Aqui
  • Autenticação
    • Gerar Token
      POST
  • Estabelecimentos
    • Criar Estabelecimento
      POST
    • Listar Estabelecimentos
      GET
    • Listar Estabelecimento por ID
      GET
  • Transações
    • Criar Transação Crédito
      POST
    • Criar Transação PIX
      POST
    • Listar Transações
      GET
    • Lista Transação ID
      GET
    • QR Code PIX
      GET
    • Simulate Transações
      POST
  • Antifraude
    • Antifraude 3DS
  • Finalizar Transação 3DS
    POST
  1. Transações

Criar Transação Crédito

POST
/transaction
Esse endpoint cria transações de crédito
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST '/transaction' \
--header 'establishmentID: {{establishment_id}}' \
--header 'Authorization: {{bearer_token}}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "payment_type": "CREDIT",
    "interest": "CLIENT",
    "amount": 46500,
    "installments": 3,
    "client": {
        "first_name": "Joao",
        "last_name": "da Silva",
        "document": "10085135046",
        "phone": "11999999999",
        "email": "email.cliente@gmail.com",
        "address": {
            "street": "Rua do Cliente",
            "number": "80",
            "complement": "Bloca A1",
            "neighborhood": "Bairro",
            "city": "Cidade",
            "state": "SP",
            "zip_code": "04548050"
        }
    },
    "card": {
        "holder_name": "Joao Silva",
        "holder_document": "10085135046",
        "card_number": "5497380067898745",
        "expiration_month": 5,
        "expiration_year": 2030,
        "security_code": "879"
    },
    "session_id": "251ff5d5-365f-4b7f-96f0-1ce42cce8cf3"
}'
Response Response Example
{
    "_id": "682b9d31852681ae93d23d97",
    "status": "PENDING",
    "amount": 46500,
    "original_amount": 47185,
    "fees": 685,
    "type": "CREDIT",
    "gateway_key": "f57f289f-b65a-42a7-9e0e-166295d9c4dd",
    "gateway_authorization": "INOVPAY",
    "card": {
        "brand_name": "MASTERCARD",
        "first4_digits": "5497",
        "last4_digits": "8745",
        "expiration_month": "5",
        "expiration_year": "2030",
        "holder_name": "JOAO SILVA",
        "_id": "682b9d31852681ae93d23d98"
    },
    "installments": 3,
    "customer": {
        "first_name": "Joao",
        "last_name": "da Silva",
        "document": "10085135046",
        "phone": "19984240923",
        "email": "testecliente@gmail.com",
        "address": {
            "street": "Rua Teste Cliente",
            "number": "80",
            "complement": "Bloco A1",
            "neighborhood": "Bairro",
            "city": "São Paulo",
            "state": "SP",
            "zip_code": "04548020"
        },
        "_id": "682b9d31852681ae93d23d99"
    },
    "point_of_sale": {
        "identification_type": "API",
        "type": "ONLINE"
    },
    "expected_on": [
        {
            "date": "2025-06-18T12:00:00.239Z",
            "amount": 15500,
            "status": "PENDING",
            "installment": 1
        },
        {
            "date": "2025-07-18T12:00:00.239Z",
            "amount": 15500,
            "status": "PENDING",
            "installment": 2
        },
        {
            "date": "2025-08-18T12:00:00.239Z",
            "amount": 15500,
            "status": "PENDING",
            "installment": 3
        }
    ],
    "antifraud": [
        {
            "analyse_status": "WAITING_AUTH",
            "analyse_required": "THREEDS",
            "_id": "682b9d31852681ae93d23db0",
            "session": "MGnvPQqHCq7lramWORRV6cbMg5fyi1h4voGMkpEKaxo8nPxfO1eys/R63EUhJXRXmFsoh/9I1mC7dPuB6n8ERr6b7DfRLHAajDm93L7GCehlO0QLElTMA7zj1X8Wz6UiLUXETIyaVbcEuULMU+E7KDWstM6qfTluPt+3GpAAQUPgI8Mf6wDswgm79AUbOMeen9DPwHLufj2f+H2h0Kfsqcnx+6CvYo6EVJX0k8OTUCgf8qVOYA3c8KV64Vd0MPZ8powgEKRz4IFLAxDylfLEyLJNOibF7vdzplWPvJSXrg8bsTUCcJXxlwtLCF7RUmdRp1yRuGASjqEM0VRLbrMxLg=="
        }
    ],
    "created_at": "2025-05-19T21:05:53.245Z"
}

Requisição

Authorization
Forneça seu token bearer no cabeçalho
Authorization
ao fazer requisições para recursos protegidos.
Exemplo:
Authorization: Bearer ********************
Parâmetros Header

Parâmetros Bodyapplication/json

Examples

Respostas

🟢201Criado
application/json
Possíveis status:
CREATED = Transação criada
PENDING = Transação em processamento
PAID = Transação confirmada
APPROVED = Transação confirmada
FAILED= Transação Negada
REFUNDED = Transação estornada
DISPUTED= Transação em estado de disputa
CANCELED= Transação foi cancelada em algum momento
CHARGEBACK = Transação com CHARGEBACK aprovada
Body

Modificado em 2025-06-11 10:54:44
Página anterior
Listar Estabelecimento por ID
Próxima página
Criar Transação PIX
Built with