Inovpay-API
  1. Transações
Inovpay-API
  • Comece Por Aqui
  • Autenticação
    • Gerar Token
      POST
  • Estabelecimentos
    • Criar Estabelecimento
      POST
    • Listar Estabelecimentos
      GET
    • Listar Estabelecimento 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
  1. Transações

Criar Transação Crédito

POST
/v1/marketplace/transactions
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST '/v1/marketplace/transactions' \
--header 'integration-key: {{integration-key}}' \
--header 'x-token: {{x-token}}' \
--header 'establishment_id: {{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": "19984240923",
        "email": "gabriel.albuquelque@gmail.com",
        "address": {
            "street": "Rua Lourenco Barbisan",
            "number": "80",
            "complement": "Bloca A1",
            "neighborhood": "Jardim Panorama",
            "city": "Valinhos",
            "state": "SP",
            "zip_code": "13277440"
        }
    },
    "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
integration-key
string 
requerido
Exemplo:
{{integration-key}}
x-token
string 
requerido
Exemplo:
{{x-token}}
establishment_id
string 
requerido
Exemplo:
{{establishment_id}}
Authorization
string 
requerido
Exemplo:
{{bearer_token}}
Parâmetros Bodyapplication/json
payment_type
string 
requerido
amount
integer 
requerido
installments
integer 
requerido
interest
string 
requerido
client
object 
requerido
first_name
string 
requerido
last_name
string 
requerido
document
string 
requerido
phone
string 
requerido
email
string 
requerido
address
object 
requerido
card
object 
requerido
holder_name
string 
requerido
holder_document
string 
requerido
card_number
string 
requerido
expiration_month
integer 
requerido
expiration_year
integer 
requerido
security_code
string 
requerido
Examples

Respostas

🟢201Criado
application/json
Body
_id
string 
requerido
status
string 
requerido
amount
integer 
requerido
original_amount
integer 
requerido
fees
integer 
requerido
type
string 
requerido
gateway_key
string 
requerido
gateway_authorization
string 
requerido
card
object 
requerido
brand_name
string 
requerido
first4_digits
string 
requerido
last4_digits
string 
requerido
expiration_month
string 
requerido
expiration_year
string 
requerido
holder_name
string 
requerido
_id
string 
requerido
installments
integer 
requerido
customer
object 
requerido
first_name
string 
requerido
last_name
string 
requerido
document
string 
requerido
phone
string 
requerido
email
string 
requerido
address
object 
requerido
_id
string 
requerido
point_of_sale
object 
requerido
identification_type
string 
requerido
type
string 
requerido
expected_on
array [object {4}] 
requerido
date
string 
requerido
amount
integer 
requerido
status
string 
requerido
installment
integer 
requerido
antifraud
array [object {4}] 
requerido
analyse_status
string 
opcional
analyse_required
string 
opcional
_id
string 
opcional
session
string 
opcional
created_at
string 
requerido
Página anterior
Listar Estabelecimento ID
Próxima página
Criar Transação PIX
Built with