API MODAPAY (1.0.0)

Download OpenAPI specification:Download

Documentação API MODAPAY

Autenticação

Operações relacionadas a login

Login de usuário

Request Body schema: application/json
required

Informar dados conforme modelo

pin
required
number

PIN do usuário

username
required
string

Email do usuário

password
required
string

Senha do usuário

Responses

Request samples

Content type
application/json
{}

Response samples

Content type
application/json
{
  • "Token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJwaW4iOjMwLCJuYW1lIjoiTU9EQVBBWSBSRVBSRVNFTlRBQ09FUyBDT01FUkNJQUlTIExUREEiLCJ0eXBlIjoiSiIsImlhdCI6MTcxNDczNjI4NywiZXhwIjoxNzE0NzY1MDg3fQ.ok3H5JdPciDRApOy4e-YKFswV6Moab3Y64A17e7Io7U",
  • "expires_at": "2024-05-03T19:38:07.229Z"
}

Atualizar senha

Authorizations:
bearerAuth
header Parameters
Authorization
required
string
Example: Bearer 123

Token de autenticação

Request Body schema: application/json
required

Informar dados conforme modelo

pin
required
number

PIN do usuário

password
required
string

Senha antiga do usuário

newPassword
required
string

Nova senha do usuário

Responses

Request samples

Content type
application/json
{
  • "pin": 1,
  • "password": "Arv@9627",
  • "newPassword": "Arv@9627"
}

Consultar Pagador

Operaçõe relacionada a consultar pagador

Consultar PixIn

Authorizations:
bearerAuth
path Parameters
e2eid
required
string
Example: F4DPDURMKJSIBR016442641715001006631

e2eid da transação COB

header Parameters
Authorization
required
string
Example: Bearer 123

Token de autenticação

Responses

Response samples

Content type
application/json
{
  • "txid": "TQ3YFRAO4LUGJF016442641712874114625",
  • "valor": 10,
  • "horario": "2024-04-11T22:23:16.099Z",
  • "infoPagador": "ModaPAY",
  • "nomePagador": "Allana Nascimento Silva",
  • "pagador": {
    },
  • "devolucoes": [ ]
}

Devoluções

Operações relacionadas a devoluções

Criar devolução

Authorizations:
bearerAuth
header Parameters
Authorization
required
string
Example: Bearer 123

Token de autenticação

Request Body schema: application/json
required

Informar dados conforme modelo

e2eid
required
string

Id fim a fim da transação

value
required
number

Valor da devolução

Responses

Request samples

Content type
application/json
{
  • "e2eid": "E18236120202405101308s0467885db9",
  • "value": 10.99
}

Response samples

Content type
application/json
{
  • "id": "Bg0Jgm0XD7Rl1sgedzwaneWzPsbYM3f7",
  • "e2eid": "E18236120202405101308s0467885db9",
  • "status": "DEVOLVIDO",
  • "solicitacao": "2024-05-21T13:44:10.482Z",
  • "hash": "FsqAYaZFXfdVN3DGDrKFMOcgOySXjN//scn5LWetN4s="
}

Consultar devolução

Authorizations:
bearerAuth
query Parameters
id
required
string
Example: id=Bg0Jgm0XD7Rl1sgedzwaneWzPsbYM3f7

ID da devolução

e2eid
required
string
Example: e2eid=E18236120202405101308s0467885db9

Id fim a fim da transação

header Parameters
Authorization
required
string
Example: Bearer 123

Token de autenticação

Responses

Response samples

Content type
application/json
{
  • "id": "Bg0Jgm0XD7Rl1sgedzwaneWzPsbYM3gi",
  • "e2eid": "E18236120202405101308s0467885da7",
  • "valor": 0.01,
  • "status": "DEVOLVIDO",
  • "solicitacao": "2024-05-21T13:44:11.636Z",
  • "liquidacao": "2024-05-21T13:44:11.636Z"
}

PIX COB

Operações relacionadas a PIX COB

Cobrança COB

Authorizations:
bearerAuth
header Parameters
Authorization
required
string
Example: Bearer 123

Token de autenticação

Request Body schema: application/json
required

Informar dados conforme modelo

expiration
number

Tempo de expiração do PIX

amount
required
number

Valor do PIX

description
required
string

Descrição do PIX

cpf
string

CPF do pagador

name
string

Nome do pagador

id_externo
string

ID exclusivo da sua aplicação

Responses

Request samples

Content type
application/json
{
  • "expiration": 3600,
  • "amount": 0.01,
  • "description": "Serviço realizado.",
  • "cpf": "30317513028",
  • "name": "Fulano de Tal",
  • "id_externo": "848299f2-0e41-4dc7-8acd-53ee5494fd9d"
}

Response samples

Content type
application/json
{
  • "chave": "1b25d41c-5161-4a5a-be4d-3a50bdc992b3",
  • "pixCopiaECola": "00020101021226900014br.gov.bcb.pix2568pix.sicoob.com.br/qr/payload/v2/45b46e24-1ba2-4b18-9cf7-b13ea287817f5204000053039865802BR5925ANA MARIA DE OLIVEIRA BAR6013Nao_informado62070503***6304CC5B",
  • "calendario": {
    },
  • "valor": {
    },
  • "txid": "F4DPDURMKJSIBR016442641715001006631",
  • "location": "pix.sicoob.com.br/qr/payload/v2/45b46e24-1ba2-4b18-9cf7-b13ea287817f",
  • "status": "ATIVA",
  • "id_externo": "848299f2-0e41-4dc7-8acd-53ee5494fd9d",
  • "hash": "FsqAYaZFXfdVN3DGDrKFMOcgOySXjN//scn5LWetN4s="
}

Cancelar COB

Authorizations:
bearerAuth
path Parameters
txid
required
string
Example: F4DPDURMKJSIBR016442641715001006631

txid da transação COB

header Parameters
Authorization
required
string
Example: Bearer 123

Token de autenticação

Responses

Consultar COB

Authorizations:
bearerAuth
query Parameters
txid
required
string
Example: txid=F4DPDURMKJSIBR016442641715001006631

txid da transação COB

header Parameters
Authorization
required
string
Example: Bearer 123

Token de autenticação

Responses

Response samples

Content type
application/json
{
  • "chave": "1b25d41c-5161-4a5a-be4d-3a50bdc992b3",
  • "solicitacaoPagador": "ModaPAY",
  • "calendario": {
    },
  • "devedor": {
    },
  • "valor": {
    },
  • "txid": "TQ3YFRAO4LUGJF016442641712874114625",
  • "status": "CONCLUIDA"
}

Listar COB

Authorizations:
bearerAuth
query Parameters
inicio
required
string
Example: inicio=2024-04-11T22:21:54Z

Data de início da busca

fim
required
string
Example: fim=2024-04-11T22:21:54Z

Data de fim da busca

cpf
string
Example: cpf=11162269448

CPF do pagador

status
string
Example: status=CONCLUIDA

Status do PIX

paginaAtual
number
Example: paginaAtual=1

Página atual

itensPorPagina
number
Example: itensPorPagina=10

Itens por página

header Parameters
Authorization
required
string
Example: Bearer 123

Token de autenticação

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Listar Pix COB processadora com status ATIVA

Authorizations:
bearerAuth
query Parameters
inicio
string
Example: inicio=2024-04-11

Data de início da busca

fim
string
Example: fim=2024-04-11

Data de fim da busca

cpf
required
string
Example: cpf=11162269448

CPF do pagador

txid
string
Example: txid=2913GXOMYCEZIZ016442641717505388669

Txid do PIX

paginaAtual
number
Example: paginaAtual=1

Página atual, se não informado, será 1

itensPorPagina
number
Example: itensPorPagina=10

Itens por página, se não informado, será 100

header Parameters
Authorization
required
string
Example: Bearer 123

Token de autenticação

Responses

Response samples

Content type
application/json
[
  • [
    ]
]

PIX COBV

Operações relacionadas a PIX COBV

Criar cobrança PIX COBV

Authorizations:
bearerAuth
header Parameters
Authorization
required
string
Example: Bearer 123

Token de autenticação

Request Body schema: application/json
required

Informar dados conforme modelo

name
required
string

Nome do pagador

cpf
required
string

CPF do pagador

description
string

Descrição da cobrança

amount
required
number

Valor do PIX

tipo_desconto
required
number

Tipo de desconto ( 0 - Nenhum desconto, 1 - Valor fixo até a data informada, 2 - Percentual até a data informada, 3 - Valor por antecipação até o dia corrido, 4 - Valor por antecipação dia útil, 5 - Percentual por antecipação até o dia corrido, 6 - Percentual por antecipação dia útil)

valor_desconto
required
number

Valor do desconto

tipo_juros
required
number

Tipo de juros (0 - Nenhum juro aplicado, 1 - Valor (dias corridos), 2 - Percentual ao dia (dias corridos), 3 - Percentual ao mês (dias corridos), 4 - Percentual ao ano (dias corridos), 5 - Valor (dias corridos), 6 - Percentual ao dia (dias úteis)

valor_juros
required
number

Valor do juros

tipo_multa
required
number

Tipo de multa (0 - Nenhum, 1 - Valor fixo, 2 - Percentual)

valor_multa
required
number

Valor da multa

vencimento
required
string

Data de vencimento do PIX

dias
required
number

Dias para vencimento

id_externo
string

ID exclusivo da sua aplicação

Responses

Request samples

Content type
application/json
{
  • "name": "Fulano de Tal",
  • "cpf": "08000000000",
  • "description": "Serviço realizado",
  • "amount": 250.2,
  • "tipo_desconto": 1,
  • "valor_desconto": 20,
  • "tipo_juros": 2,
  • "valor_juros": 2,
  • "tipo_multa": 1,
  • "valor_multa": 10,
  • "vencimento": "20/05/2024",
  • "dias": 7,
  • "id_externo": "848299f2-0e41-4dc7-8acd-53ee5494fd9d"
}

Response samples

Content type
application/json
{
  • "chave": "60cf8bfa-5624-4572-aabd-c0a498a8e4e2",
  • "solicitacaoPagador": "ModaPAY",
  • "pixCopiaECola": "00020101021226950014br.gov.bcb.pix2573pix.sicoob.com.br/qr/payload/v2/cobv/f14bfa13-63b0-420b-8a24-11d45c9fbbdb5204000053039865802BR5925ANA MARIA DE OLIVEIRA BAR6013Nao_informado62070503***6304D940",
  • "calendario": {
    },
  • "devedor": {
    },
  • "recebedor": {
    },
  • "valor": {
    },
  • "txid": "7F0QW6VY6WIKTROOSKWX4KVYU7OJSR6H",
  • "revisao": 0,
  • "status": "ATIVA",
  • "id_externo": "848299f2-0e41-4dc7-8acd-53ee5494fd9d",
  • "hash": "FsqAYaZFXfdVN3DGDrKFMOcgOySXjN//scn5LWetN4s="
}

Cancelar cobrança PIX COBV

Authorizations:
bearerAuth
path Parameters
txid
required
string
Example: 7F0QW6VY6WIKTROOSKWX4KVYU7OJSR6H

ID da transação do PIX

header Parameters
Authorization
required
string
Example: Bearer 123

Token de autenticação

Responses

Consultar Pix COBV

Authorizations:
bearerAuth
query Parameters
txid
required
string
Example: txid=7F0QW6VY6WIKTROOSKWX4KVYU7OJSR6H

Id da transação

header Parameters
Authorization
required
string
Example: Bearer 123

Token de autenticação

Responses

Response samples

Content type
application/json
{
  • "chave": "60cf8bfa-5624-4572-aabd-c0a498a8e4e2",
  • "solicitacaoPagador": "ModaPAY",
  • "pixCopiaECola": "00020101021226950014br.gov.bcb.pix2573pix.sicoob.com.br/qr/payload/v2/cobv/f14bfa13-63b0-420b-8a24-11d45c9fbbdb5204000053039865802BR5925ANA MARIA DE OLIVEIRA BAR6013Nao_informado62070503***6304D940",
  • "calendario": {
    },
  • "devedor": {
    },
  • "recebedor": {
    },
  • "valor": {
    },
  • "txid": "7F0QW6VY6WIKTROOSKWX4KVYU7OJSR6H",
  • "revisao": 0,
  • "status": "ATIVA"
}

Listar Pix COBV

Authorizations:
bearerAuth
query Parameters
inicio
required
string
Example: inicio=2024-04-11T22:21:54Z

Data de início da busca

fim
required
string
Example: fim=2024-04-11T22:21:54Z

Data de fim da busca

cpf
string
Example: cpf=11162269448

CPF do pagador

status
string
Example: status=CONCLUIDA

Status do PIX

paginaAtual
number
Example: paginaAtual=1

Página atual

itensPorPagina
number
Example: itensPorPagina=10

Itens por página

header Parameters
Authorization
required
string
Example: Bearer 123

Token de autenticação

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Listar Pix COBV processadora com status ATIVA

Authorizations:
bearerAuth
query Parameters
inicio
string
Example: inicio=2024-04-11

Data de início da busca

fim
string
Example: fim=2024-04-11

Data de fim da busca

cpf
required
string
Example: cpf=11162269448

CPF do pagador

txid
string
Example: txid=2913GXOMYCEZIZ016442641717505388669

Txid do PIX

paginaAtual
number
Example: paginaAtual=1

Página atual, se não informado, será 1

itensPorPagina
number
Example: itensPorPagina=10

Itens por página, se não informado, será 100

header Parameters
Authorization
required
string
Example: Bearer 123

Token de autenticação

Responses

Response samples

Content type
application/json
[
  • [
    ]
]

PIX Estático

Operações relacionadas a PIX COBV processadora

Gerar qrCode estático

Authorizations:
bearerAuth
header Parameters
Authorization
required
string
Example: Bearer 123

Token de autenticação

Request Body schema: application/json
description
string

Descrição da cobrança

id_externo
string

ID externo da cobrança

Responses

Request samples

Content type
application/json
{
  • "description": "Descrição da cobrança",
  • "id_externo": "848299f2-0e41-4dc7-8acd-53ee5494fd9d"
}

Response samples

Content type
application/json
{
  • "txId": "c56a6934ed284e6d1f8661bf5",
  • "pixCopiaECola": "00020126760014br.gov.bcb.pix0136fd31ba6d-f5bc-42c5-9e7f-20b4f6498c9b0214teste estático5204000053039865802BR5907RAIZBET6008TORITAMA62290525c56a8934ed984e5d8f1662bf46304CF16"
}

PixOut

Operações relacionadas a PixOut

Transferência PixOut

Authorizations:
bearerAuth
header Parameters
Authorization
required
string
Example: Bearer 123

Token de autenticação

Request Body schema: application/json
required

Informar dados conforme modelo

password
string

Senha de transação, (requerido em caso de login de usuário)

amount
required
number

Valor do PIX

description
string

Descrição do PIX

method
required
string

Método de pagamento (cpf, cnpj, email, phone, evp)

key
required
string

Chave PIX - modelos aceitos: (cpf: '12345678901', cnpj: '12345678912345', phone: '+5521991864525', email: 'email@email.com', evp: '4bb4fdc5-6836-4f1a-aa7e-036100195a84')

name
string

Nome do recebedor

cpf
string

CPF do recebedor

id_externo
string

ID exclusivo da sua aplicação

Responses

Request samples

Content type
application/json
{
  • "password": "Senha@19",
  • "amount": 0.05,
  • "description": "teste integracao",
  • "method": "phone",
  • "key": "+5511999999999",
  • "name": "Fulano de tal",
  • "cpf": "08030013000",
  • "id_externo": "848299f2-0e41-4dc7-8acd-53ee5494fd9d"
}

Response samples

Content type
application/json
{
  • "transfer_request_id": "128629C780F849D28221040B66E655CA",
  • "created_at": "2024-05-06T10:27:16-03:00",
  • "amount_cents": 13,
  • "transfer_type": "pix",
  • "end_to_end_id": "E151119752024050613272449ea4737c",
  • "external_reference": null,
  • "status": "processing",
  • "id_externo": "848299f2-0e41-4dc7-8acd-53ee5494fd9d",
  • "hash": "FsqAYaZFXfdVN3DGDrKFMOcgOySXjN//scn5LWetN4s="
}

Consultar PixOut

Authorizations:
bearerAuth
query Parameters
id
required
string
Example: id=F4DPDURMKJSIBR016442641715001006631

Id da transação

header Parameters
Authorization
required
string
Example: Bearer 123

Token de autenticação

Responses

Response samples

Content type
application/json
{
  • "id_transacao": "128629C780F849D28221040B66E655CA",
  • "end_to_end_id": "E151119752024050613272449ea4737c",
  • "nome": "Fullano de tal",
  • "cpf": "***.052.654-**",
  • "descricao": "teste integracao",
  • "method": "cpf",
  • "chave": "080052654000",
  • "valor": 5,
  • "conclusao": "2024-05-06T10:27:19-03:00",
  • "status": "executed",
  • "rejected": null
}

Saldo

Operações relacionadas a saldo

Saldo

Authorizations:
bearerAuth
header Parameters
Authorization
required
string
Example: Bearer 123

Token de autenticação

Responses

Response samples

Content type
application/json
{
  • "pin": 30,
  • "pix_in": 100.55,
  • "pix_out": 90.95,
  • "saldo": 9.6,
  • "hash": "FsqAYaZFXfdVN3DGDrKFMOcgOySXjN//scn5LWetN4s="
}

Webhook

Operações relacionadas a webhooks retornados

Webhook PixOut

Responses

Response samples

Content type
application/json
{
  • "pin": 0,
  • "id_transacao": "128629C780F849D28221040B66E65",
  • "endToEndId": "E151119752024050613272449ea4701c",
  • "nome": "Fullano de tal",
  • "cpf": "080052654000",
  • "descricao": "teste integracao",
  • "chave": "080052654000",
  • "valor": 19000,
  • "taxa_total": 0.1,
  • "conclusao": "2024-03-22T00:19:52.000Z",
  • "status": "executed",
  • "sender_account": {
    },
  • "receiver_account": {
    },
  • "erroDescricao": "Motivo do erro",
  • "id_externo": "848299f2-0e41-4dc7-8acd-53ee5494fd9d",
  • "hash": "FsqAYaZFXfdVN3DGDrKFMOcgOySXjN//scn5LWetN4s="
}

Webhook PixIn

Responses

Response samples

Content type
application/json
{
  • "txid": "TQ3YFRAO4LUGJF016442641712874114625",
  • "status": "CONCLUIDA",
  • "data_pagamento": "2024-05-10T13:08:40.000Z",
  • "amount_paid": 10.55,
  • "total_fee": 0.1,
  • "end_to_end_id": "E151119752024050613272449ea4737c",
  • "payer_name": "FULANO DE TAL",
  • "payer_document": "00000000000",
  • "devolutions": [
    ],
  • "id_externo": "848299f2-0e41-4dc7-8acd-53ee5494fd9d",
  • "hash": "FsqAYaZFXfdVN3DGDrKFMOcgOySXjN//scn5LWetN4s="
}

Comparar hash

Compara o hash

header Parameters
Authorization
required
string
Example: Bearer token

Token de autenticação

Request Body schema: application/json
hash
required
string

Hash a ser comparado

campos
string

substitua 'campos' pelos campos que compoem o hash

Responses

Request samples

Content type
application/json
{
  • "hash": "FsqAYaZFXfdVN3DGDrKFMOcgOySXjN//scn5LWetN4s=",
  • "campos": "substitua 'campos' pelos campos que compoem o hash"
}

Response samples

Content type
application/json
true