A API usa códigos de status HTTP padrão para indicar o sucesso ou falha da chamada da API. O corpo da resposta será JSON no seguinte formato:
{
  "message": "Algo deu errado."
}
A autenticação é tratada no lado do cliente. O cliente precisa enviar detalhes de autenticação para vários endpoints
para que o recurso possa ser obtido de forma correta, os detalhes precisam ser enviado no cabeçalho Authorization
com um prefixo Basic e a sua chave de API (codificada em Base64) que recebeu no cadastro na plataforma.
Suponhamos que sua chave de API seja minha-chave-de-api. Você deverá enviar uma string codificada em Base64 no
seguinte formato :minha-chave-de-api, mantenha o : (dois pontos) na string. O resultado final será algo parecido
com o conteúdo abaixo.
Authorization: Basic Om1pbmhhLWNoYXZlLWRlLWFwaQ==
basicCria uma nova conta digital.
| name required  | string  Nome completo do titular da conta  | 
| gender | string  Enum: "M" "F"   Gênero / Sexo  | 
| birthDate required  | string <date>   Data de nascimento no formato ISO-8601.  | 
| email required  | string  Um e-mail válido.  | 
| password | string  [ 8 .. 12 ] characters   Senha de acesso a conta digital. Caso não seja informado uma senha, o sitema criará uma senha randômica.  | 
| cpf required  | string  CPF válido  | 
object   | |
required  | object   | 
required  | object   | 
required  | Array of objects (Account Document)   Lista de documentos  | 
{- "name": "Foo Bar",
 - "gender": "M",
 - "birthDate": "2019-08-24",
 - "email": "foo@bar.com",
 - "password": 12345678,
 - "cpf": 45576360044,
 - "rg": {
- "number": 36864316,
 - "emitter": "SSP",
 - "emitDate": "2019-08-24"
 
}, - "address": {
- "zipcode": 5999,
 - "street": "Av. São Paulo",
 - "number": 1,
 - "state": "SP",
 - "city": "São Paulo",
 - "neighborhood": "Vila Olímpia",
 - "complement": "string"
 
}, - "phone": {
- "ddd": 11,
 - "number": 989691336
 
}, - "documents": [
- {
- "type": "cpf",
 - "fileFormat": "image/png",
 - "file": "iVBORw0KGgoAAAANSUhEUgAAAV4AAACWBAMAAABkyf1EAAAAG1BMVEXMzMyWlpacnJyqqqrFxcWxsbGjo6O3t7e+vr6He3KoAAAACXBIWXMAAA7EAAAOxAGVKw4bAAAEcElEQVR4nO2aTW/bRhCGh18ij1zKknMkbbf2UXITIEeyMhIfRaF1exQLA/JRclslRykO+rs7s7s0VwytNmhJtsA8gHZEcox9PTs7uysQgGEYhmEYhmEYhmEYhmEYhmEYhmEYhmEYhmEYhmEYhmGYr2OWRK/ReIKI8Zt7Hb19wTcQ0uTkGh13bQupcw7gPOvdo12/5CzNtNR7xLUtNtT3CGBQ6g3InjY720pvofUec22LJPr8PhEp2OMPyI40PdwWUdronCu9yQpdPx53bQlfLKnfOVhlnDYRBXve4Ov+IZTeMgdedm0NR+xoXJeQvdJ3CvziykSukwil16W/Oe7aGjIjqc/9ib4jQlJy0uArtN4A0+cvXFvDkmUJ47sJ1Y1ATLDNVXZkNPIepQzxy1ki9fqiwbUj/I+64zxWNzyZnPuhvohJ9K70VvXBixpcu2SAHU+Xd9EKdEJDNpYP3AQr3bQSpPQ6Y6/4dl1z7ZDbArsszjA7L0g7ibB0CDcidUWVoErvIMKZh2Xs0LUzcLW6V5NfiUgNEbaYmAVL6bXl0nJRc+1S72ua/D/cTjGPlQj7eUqd7A096rYlRjdPYlhz7VIvxpVG3cemDKF+WAwLY/6XelOZKTXXzsC4xvDjjtSN6kHLhLke6PrwM8h1raf40qjrGO7H9aTEbduucjS04ZrYU/4iuS5Z2Hdt0rvCLFdmLEXcU30AGddST62o+sLcf5l6k7CP+ru4pLYqX/VFyxbm/utQbx/r22ZEbTb2f5I2kns1Y1OQR8ZyofX+TjJxj1Rz7QQVnf1QzR26Oth0ueJVYcRP6ZUPac/Rx/5M6ixO1dhSrT3Y1DpiYmx3tF4ZUdpz9LD/dSg9PXES0LB71BwcGjKROuV28lnvnv7HHJsezheBGH5+X2CfSfRbMKW+5aGs3JFjMrjGibJc0S7TJzqjHrh2hDybj9XRXNZa89Aro55XBdbW5wti2c/5WJ7jJ1RolVUn/HWpb0I58Tziup6Rx7Dm2hnbRP1GM9PW/NFmQ4PtVRVN63Wvxfmu5sowDMMwDMMwDMMwDMMwDMMwDMMwzL+CpT//F/6beoV8zb2Jmt4Qryx6lTUCsENQ75HOkhXAO3EPVgyQtKtUy3C/e+FJg17Zjnew1Xrdb9InbG4WqfUAftG+WhLwPVyfg536+MU7m4C1CMk4ZznpXZzDYI1PDL2nS1hpvc5cNd7E2sJg05Fe7/7d3Fln8Cvc3bwB616auxsKl4WPghjemHrDqyDWeu1UNW5s2btPnSQ75oOdunEwWazfwgVG0kqluYCM9OIjWOGnfA2b9G4Ha63XKpvQ8perTvTifJNhi6+WMWmi7smEZf6G8MmhlyGq+NqP8GV84TLuJr7UIQVx+bDEoEpRZIz42gs40OuN4Mv8hXzelV7KX1isH+ewTWckikyVv+CfHuqVF7I16gN0VKypX6wPsE+zFPzkinolU9UH8OMGvSpnZqKsv13p/RsMun6X5x/y2LeAr8O66lsBwzBMP/wJfyGq8pgBk6IAAAAASUVORK5CYII="
 
} 
] 
}{- "account": {
- "bankCode": "093",
 - "agency": "0001",
 - "accountDigit": "0",
 - "accountNumber": "138338",
 - "holderName": "Foo Bar",
 - "password": 12345678
 
}, - "status": "doc_pending",
 - "docs": [
- {
- "id": 848172,
 - "type": "cpf",
 - "status": "pending"
 
} 
] 
}Busca uma conta com o termo especificado.
| q required  | string   Example:  q=45576360044 Termo da consulta  | 
| type | string  Default:  "cpf"  Enum: "cpf" "email" "phone" "account"    Example:  type=cpf Informa o tipo de pesquisa a ser realizado, os valores possíveis são: 
  | 
{- "account": {
- "bankCode": "093",
 - "agency": "0001",
 - "accountDigit": "0",
 - "accountNumber": "138338",
 - "holderName": "Foo Bar"
 
}, - "status": "doc_pending",
 - "docs": [
- {
- "id": 848172,
 - "type": "cpf",
 - "status": "pending"
 
} 
] 
}Atualizar um documento enviado anteriormente
| accountNumber required  | string   Example:  138338 Número da conta  | 
| documentId required  | string   Example:  848172 ID do documento  | 
| type required  | string  Enum: "cpf" "rg" "cnh" "proof_address"   Tipo de documento, CPF, RG, CNH ou Comprovante de Residência  | 
| fileFormat | string  Enum: "image/png" "image/jpeg" "application/pdf"   Formato do arquivo enviado  | 
| file required  | string <base64>   Conteúdo do arquivo em formato Base64  | 
{- "type": "cpf",
 - "fileFormat": "image/png",
 - "file": "iVBORw0KGgoAAAANSUhEUgAAAV4AAACWBAMAAABkyf1EAAAAG1BMVEXMzMyWlpacnJyqqqrFxcWxsbGjo6O3t7e+vr6He3KoAAAACXBIWXMAAA7EAAAOxAGVKw4bAAAEcElEQVR4nO2aTW/bRhCGh18ij1zKknMkbbf2UXITIEeyMhIfRaF1exQLA/JRclslRykO+rs7s7s0VwytNmhJtsA8gHZEcox9PTs7uysQgGEYhmEYhmEYhmEYhmEYhmEYhmEYhmEYhmEYhmEYhmGYr2OWRK/ReIKI8Zt7Hb19wTcQ0uTkGh13bQupcw7gPOvdo12/5CzNtNR7xLUtNtT3CGBQ6g3InjY720pvofUec22LJPr8PhEp2OMPyI40PdwWUdronCu9yQpdPx53bQlfLKnfOVhlnDYRBXve4Ov+IZTeMgdedm0NR+xoXJeQvdJ3CvziykSukwil16W/Oe7aGjIjqc/9ib4jQlJy0uArtN4A0+cvXFvDkmUJ47sJ1Y1ATLDNVXZkNPIepQzxy1ki9fqiwbUj/I+64zxWNzyZnPuhvohJ9K70VvXBixpcu2SAHU+Xd9EKdEJDNpYP3AQr3bQSpPQ6Y6/4dl1z7ZDbArsszjA7L0g7ibB0CDcidUWVoErvIMKZh2Xs0LUzcLW6V5NfiUgNEbaYmAVL6bXl0nJRc+1S72ua/D/cTjGPlQj7eUqd7A096rYlRjdPYlhz7VIvxpVG3cemDKF+WAwLY/6XelOZKTXXzsC4xvDjjtSN6kHLhLke6PrwM8h1raf40qjrGO7H9aTEbduucjS04ZrYU/4iuS5Z2Hdt0rvCLFdmLEXcU30AGddST62o+sLcf5l6k7CP+ru4pLYqX/VFyxbm/utQbx/r22ZEbTb2f5I2kns1Y1OQR8ZyofX+TjJxj1Rz7QQVnf1QzR26Oth0ueJVYcRP6ZUPac/Rx/5M6ixO1dhSrT3Y1DpiYmx3tF4ZUdpz9LD/dSg9PXES0LB71BwcGjKROuV28lnvnv7HHJsezheBGH5+X2CfSfRbMKW+5aGs3JFjMrjGibJc0S7TJzqjHrh2hDybj9XRXNZa89Aro55XBdbW5wti2c/5WJ7jJ1RolVUn/HWpb0I58Tziup6Rx7Dm2hnbRP1GM9PW/NFmQ4PtVRVN63Wvxfmu5sowDMMwDMMwDMMwDMMwDMMwDMMwzL+CpT//F/6beoV8zb2Jmt4Qryx6lTUCsENQ75HOkhXAO3EPVgyQtKtUy3C/e+FJg17Zjnew1Xrdb9InbG4WqfUAftG+WhLwPVyfg536+MU7m4C1CMk4ZznpXZzDYI1PDL2nS1hpvc5cNd7E2sJg05Fe7/7d3Fln8Cvc3bwB616auxsKl4WPghjemHrDqyDWeu1UNW5s2btPnSQ75oOdunEwWazfwgVG0kqluYCM9OIjWOGnfA2b9G4Ha63XKpvQ8perTvTifJNhi6+WMWmi7smEZf6G8MmhlyGq+NqP8GV84TLuJr7UIQVx+bDEoEpRZIz42gs40OuN4Mv8hXzelV7KX1isH+ewTWckikyVv+CfHuqVF7I16gN0VKypX6wPsE+zFPzkinolU9UH8OMGvSpnZqKsv13p/RsMun6X5x/y2LeAr8O66lsBwzBMP/wJfyGq8pgBk6IAAAAASUVORK5CYII="
 
}{- "id": 848192,
 - "type": "cpf"
 
}Transferência bancária de valores.
OBSERVAÇÃO
Para realização da transferência é necessário ter um token de authenticação (authToken), que pode ser obtido
fazendo uma requisição para a rota de obtenção de token.
| amount required  | number  O valor a ser transferido em centavos. Ex.: R$ 1,00 = 100  | 
| holderCpf required  | string  CPF do titular da conta destino do dinheiro.  | 
| authToken | string <uuid>   Token de autenticação.  | 
{- "amount": 100,
 - "holderCpf": "76430473910",
 - "authToken": "007431a5-f913-4a19-8dd6-9350bb7229f6"
 
}{- "message": "Saldo insuficiente."
 
}Disparo de confirmação de pagamento de Boleto. Para utilização deste serviço
é necessário que nos seja informado uma url para que possamos cadastrar
em nosso sistema de disparos.
object  informações do envento a ser disparado  | 
{- "event": {
- "type": "bankslip",
 - "createdAt": "2021-01-27T14:43:37.706Z",
 - "data": {
- "bankslip": {
- "id": "b913dda7-f6d6-45b3-b687-102b05a3e106",
 - "customCode": "order123",
 - "amount": 100,
 - "amountPaid": 100,
 - "qrCode": "00020126580014br.gov.bcb.pix01366b4baa8d-f70f-43cf-8593-631c34fff657520400005303986540510.005802BR5907TYESTE26007SO PAUA62270523000000001000000000004376304A67C",
 - "paidAt": "2021-01-27T11:22:40.000Z",
 - "status": "paid"
 
} 
} 
} 
}Gerar um novo boleto.
| amount required  | string  O valor do boleto em centavos. Ex.: R$10 = 1000  | 
| dueDate required  | string  Data de vencimento do boleto no formato   | 
required  | object  Dados do pagador.  | 
| customCode | string  Código do cliente, um código personalizado que o cliente pode usar para consultas futuras.  | 
| instructions | string  Instruções  | 
{- "amount": "1000",
 - "dueDate": "2020-12-05",
 - "payerData": {
- "name": "Foo Bar",
 - "documentNumber": "01234567899",
 - "phoneNumber": "74988570796"
 
}, - "customCode": "order123",
 - "instructions": "Após o pagamento, consulte seu saldo no aplicativo"
 
}{- "id": "8a9d35b5-33d9-4a94-b580-218ab4188fe8",
 - "amount": 1000,
 - "digitableLine": "34191.09008 10856.080394 30277.840002 2 83390000001000",
 - "dueDate": "2019-08-24T14:15:22Z",
 - "status": "pending"
 
}Realizar download de um boleto gerado anteriormente através do ID.
| id required  | string   Example:  8a9d35b5-33d9-4a94-b580-218ab4188fe8  | 
{- "message": "Boleto não encontrado ou não disponível."
 
}Disparo de confirmação de pagamento de PIX. Para utilização deste serviço
é necessário que nos seja informado uma url para que possamos cadastrar
em nosso sistema de disparos.
object  informações do envento a ser disparado  | 
{- "event": {
- "type": "pix",
 - "createdAt": "2021-01-27T14:43:37.706Z",
 - "data": {
- "pix": {
- "id": "b913dda7-f6d6-45b3-b687-102b05a3e106",
 - "customCode": "order123",
 - "amount": 100,
 - "amountPaid": 100,
 - "qrCode": "00020126580014br.gov.bcb.pix01366b4baa8d-f70f-43cf-8593-631c34fff657520400005303986540510.005802BR5907TYESTE26007SO PAUA62270523000000001000000000004376304A67C",
 - "paidAt": "2021-01-27T11:22:40.000Z",
 - "status": "paid"
 
} 
} 
} 
}Pesquisa transação por customCode.
| customCode | string  
  | 
[- {
- "id": "ae64fd9e-33f7-4ad0-950e-88ff394a01c9",
 - "amount": 1000,
 - "status": "pending",
 - "provider": "gerencianet",
 - "customer": {
- "name": "Foo Bar",
 - "documentNumber": 1245678900
 
}, - "metadata": {
- "paymentId": "fd285690599c4e2bb74f8d78755d1466",
 - "nsu": "string",
 - "qrCode": "00020126580014br.gov.bcb.pix01366b4baa8d-f70f-43cf-8593-631c34fff65752040000530398654045.005802BR5907TYESTE26007SO PAUA62270523000000000500000000002706304D0D9",
 - "customCode": 1234
 
}, - "createdAt": "2019-08-24T14:15:22Z"
 
} 
]Solicitar geração de código Pix.
| amount required  | number  O valor do pix em centavos. Ex.: R$10 = 1000  | 
| customCode | string  Código do cliente, um código personalizado que o cliente pode usar para consultas futuras.  | 
object (Customer)    | |
| instructions | string  Instruções de pagamento para o pix.  | 
| paymentId | string  Id do pagamento, o mesmo é gerado de forma automática, caso queira passar manualmente é possivel por este campo.  | 
| expire | number  Tempo de expiração para o pix  | 
{- "amount": "1000",
 - "customCode": "order123",
 - "customer": {
- "name": "FULANO DE TAL",
 - "email": "foo@bar.com",
 - "phoneNumber": 11123451234,
 - "birthdate": "1990-01-01",
 - "address": {
- "street": "Rua do Alecrim",
 - "number": "S/N",
 - "country": "BR",
 - "state": "SP",
 - "zipCode": 45002100,
 - "city": "São Paulo",
 - "complement": "string",
 - "neighborhood": "Jardim São Paulo"
 
} 
}, - "instructions": "Após o pagamento, consulte seu titulo 1 no app.",
 - "paymentId": "00000hipercapmogi121640000300221295",
 - "expire": 3600
 
}{- "id": "ae64fd9e-33f7-4ad0-950e-88ff394a01c9",
 - "amount": 1000,
 - "qrCode": "00020126580014br.gov.bcb.pix01366b4baa8d-f70f-43cf-8593-631c34fff65752040000530398654045.005802BR5907TYESTE26007SO PAUA62270523000000000500000000002706304D0D9",
 - "status": "pending",
 - "gatewayId": "4"
 
}Solicitar geração de código Pix com QRCode estático. (Infra)
| amount required  | string  O valor do pix em centavos. Ex.: R$10 = 1000  | 
| customCode | string  Código do cliente, um código personalizado que o cliente pode usar para consultas futuras.  | 
| receiverName | string  Nome de quem vai receber  | 
| receiverCity | string  Cidade de quem vai receber  | 
| instructions | string  Intruções  | 
{- "amount": "1000",
 - "customCode": "order123",
 - "receiverName": "Idea Maker Solution",
 - "receiverCity": "Sao Paulo",
 - "instructions": "Após o pagamento, consulte seu saldo no aplicativo"
 
}{- "id": "RTSiOsXnFBWKCMlmkA2EdjqIe",
 - "qrCode": "00020101021126360014BR.GOV.BCB.PIX01141379439900017152040000530398654040.015802BR5925Idea Maker Meios de Pagam6015Santana de Parn62290525RTSiOsXnFBWKCMlmkA2EdjqIe63041DBB"
 
}Solicitar geração de código Pix com QRCode estático.
| amount required  | string  O valor do pix em centavos. Ex.: R$10 = 1000  | 
| customCode | string  Código do cliente, um código personalizado que o cliente pode usar para consultas futuras.  | 
| instructions | string  Intruções  | 
{- "amount": "1000",
 - "customCode": "order123",
 - "instructions": "Após o pagamento, consulte seu saldo no aplicativo"
 
}{- "id": "RTSiOsXnFBWKCMlmkA2EdjqIe",
 - "qrCode": "00020101021126360014BR.GOV.BCB.PIX01141379439900017152040000530398654040.015802BR5925Idea Maker Meios de Pagam6015Santana de Parn62290525RTSiOsXnFBWKCMlmkA2EdjqIe63041DBB"
 
}Solicitar cancelamento de Pix em massa
| customCodes required  | Array of arrays  Códigos dos clientes, um código personalizado que o cliente pode usar para consultas futuras.  | 
{- "customCodes": [
- "order123",
 - "order456"
 
] 
}{- "message": "Não foi possível processar o cancelamento."
 
}Solicitar vinculação com Split.
| id required  | string   Example:  8a9d35b5-33d9-4a94-b580-218ab4188fe8 ID do Split.  | 
| customCode required  | string  Código do cliente, um código personalizado que o cliente pode usar para consultas futuras.  | 
{- "customCode": "order123"
 
}{- "message": "Pix não encontrado."
 
}Solicitar reabilitação de código Pix com QRCode estático.
| id required  | string   Example:  8a9d35b5-33d9-4a94-b580-218ab4188fe8 ID da transação.  | 
| customCode required  | string  Código do cliente, um código personalizado que o cliente pode usar para consultas futuras.  | 
{- "customCode": "order123"
 
}{- "id": "RTSiOsXnFBWKCMlmkA2EdjqIe",
 - "amount": "1000",
 - "status": "pending",
 - "qrCode": "00020101021126360014BR.GOV.BCB.PIX01141379439900017152040000530398654040.015802BR5925Idea Maker Meios de Pagam6015Santana de Parn62290525RTSiOsXnFBWKCMlmkA2EdjqIe63041DBB"
 
}Encontrar Pix por ID e adicionar Metadata.
| id required  | string   Example:  8a9d35b5-33d9-4a94-b580-218ab4188fe8 ID da transação.  | 
| customCode required  | string  Código do cliente, um código personalizado que o cliente pode usar para consultas futuras.  | 
{- "customCode": "order123"
 
}{- "id": "RTSiOsXnFBWKCMlmkA2EdjqIe",
 - "amount": "1000",
 - "status": "pending",
 - "provider": "gerencianet",
 - "customer": {
- "name": "Foo Bar",
 - "documentNumber": 1245678900
 
}, - "metadata": {
- "paymentId": "fd285690599c4e2bb74f8d78755d1466",
 - "nsu": "fd285690599c4e2bb74f8d78755d1466",
 - "qrCode": "00020126580014br.gov.bcb.pix01366b4baa8d-f70f-43cf-8593-631c34fff657520400005303986540510.005802BR5907TYESTE26007SO PAUA62270523000000001000000000004376304A67C",
 - "customCode": 1234
 
} 
}Pesquisa uma trancação por ID.
| id required  | string  ID da transação.  | 
{- "id": "ae64fd9e-33f7-4ad0-950e-88ff394a01c9",
 - "amount": 1000,
 - "status": "pending",
 - "provider": "gerencianet",
 - "customer": {
- "name": "Foo Bar",
 - "documentNumber": 1245678900
 
}, - "metadata": {
- "paymentId": "fd285690599c4e2bb74f8d78755d1466",
 - "nsu": "string",
 - "qrCode": "00020126580014br.gov.bcb.pix01366b4baa8d-f70f-43cf-8593-631c34fff65752040000530398654045.005802BR5907TYESTE26007SO PAUA62270523000000000500000000002706304D0D9",
 - "customCode": 1234
 
}, - "createdAt": "2019-08-24T14:15:22Z"
 
}Solicita estorno de uma transação Pix.
| amount | string  O valor do reembolso em centavos. Ex.: R$10 = 1000. Se não informado o valor total da transação será estornado.  | 
{- "amount": "1000"
 
}{- "id": "b913dda7-f6d6-45b3-b687-102b05a3e106",
 - "amount": 100,
 - "status": "string",
 - "provider": "gerencianet",
 - "customer": {
- "name": "Fulano de tal",
 - "address": {
- "number": "S/N",
 - "zipCode": 45002100,
 - "street": "Rua do Alecrim"
 
} 
}, - "capturedDate": "2021-01-27T14:43:37.706Z",
 - "metadata": {
- "customCode": "my-custom-code",
 - "paymentId": 56334178649
 
}, - "createdAt": "2021-01-27T14:43:37.706Z"
 
}Envio de valores para contas bancárias ou chaves Pix.
| amount required  | string  O valor do reembolso em centavos. Ex.: R$10 = 1000. Se não informado o valor total da transação será estornado.  | 
required  | object   | 
| customCode | string   | 
{- "amount": "1000",
 - "favored": {
- "pixKey": "d2d3e39b-1a14-4650-9524-3c0eb8042aba",
 - "pixType": "chaveAleatoria"
 
}, - "customCode": "codigo-personalizado"
 
}{- "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
 - "amount": 1000,
 - "status": "pending"
 
}Um POST para a URL cadastrada em nossos sistema será enviado toda vez que houver uma alteração de status na transação
object   | 
{- "event": {
- "type": "creditCard",
 - "createdAt": "2019-08-24T14:15:22Z",
 - "data": {
- "creditCard": {
- "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
 - "amount": 1000,
 - "status": "paid",
 - "provider": "cielo",
 - "customer": {
- "name": "FULANO DE TAL",
 - "email": "foo@bar.com",
 - "phoneNumber": 11123451234,
 - "birthdate": "1990-01-01",
 - "address": {
- "street": "Rua do Alecrim",
 - "number": "S/N",
 - "country": "BR",
 - "state": "SP",
 - "zipCode": 45002100,
 - "city": "São Paulo",
 - "complement": "string",
 - "neighborhood": "Jardim São Paulo"
 
} 
}, - "refundedDate": "2019-08-24T14:15:22Z",
 - "refundedAmount": 500,
 - "capturedDate": "2019-08-24T14:15:22Z",
 - "metadata": {
- "paymentId": "aa205f8b-2b1d-4a02-875f-a19fbb14325c",
 - "returnCode": "6",
 - "returnMessage"": "Operation Successful",
 - "autorizationCode": "175766"
 
} 
} 
} 
} 
}Pesquisa uma trancação por ID.
| id required  | string  ID da transação.  | 
{- "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
 - "amount": 1000,
 - "status": "paid",
 - "provider": "cielo",
 - "customer": {
- "name": "FULANO DE TAL",
 - "email": "foo@bar.com",
 - "phoneNumber": 11123451234,
 - "birthdate": "1990-01-01",
 - "address": {
- "street": "Rua do Alecrim",
 - "number": "S/N",
 - "country": "BR",
 - "state": "SP",
 - "zipCode": 45002100,
 - "city": "São Paulo",
 - "complement": "string",
 - "neighborhood": "Jardim São Paulo"
 
} 
}, - "refundedDate": "2019-08-24T14:15:22Z",
 - "refundedAmount": 500,
 - "capturedDate": "2019-08-24T14:15:22Z",
 - "metadata": {
- "paymentId": "aa205f8b-2b1d-4a02-875f-a19fbb14325c",
 - "returnCode": "6",
 - "returnMessage"": "Operation Successful",
 - "autorizationCode": "175766"
 
} 
}Faz um cancelamento / estorno de uma transação. Ao fazer o envio a solicitação é colocada em processamento para refund, retornando como refund_requested, tendo até 24h para o refund ser concluído.
| id required  | string  ID da transação.  | 
| amount | integer  Valor do estorno.  | 
{- "amount": 500
 
}{- "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
 - "amount": 1000,
 - "status": "refund_requested",
 - "provider": "cielo",
 - "customer": {
- "name": "FULANO DE TAL",
 - "email": "foo@bar.com",
 - "phoneNumber": 11123451234,
 - "birthdate": "1990-01-01",
 - "address": {
- "street": "Rua do Alecrim",
 - "number": "S/N",
 - "country": "BR",
 - "state": "SP",
 - "zipCode": 45002100,
 - "city": "São Paulo",
 - "complement": "string",
 - "neighborhood": "Jardim São Paulo"
 
} 
}, - "refundedDate": "2019-08-24T14:15:22Z",
 - "refundedAmount": 500,
 - "capturedDate": "2019-08-24T14:15:22Z",
 - "metadata": {
- "paymentId": "aa205f8b-2b1d-4a02-875f-a19fbb14325c",
 - "returnCode": "6",
 - "returnMessage"": "Operation Successful",
 - "autorizationCode": "175766"
 
} 
}Pesquisa uma transação por customCode.
| customCode required  | string  
  | 
| providerName | string  
  | 
[- {
- "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
 - "amount": 1000,
 - "status": "paid",
 - "provider": "cielo",
 - "customer": {
- "name": "FULANO DE TAL",
 - "email": "foo@bar.com",
 - "phoneNumber": 11123451234,
 - "birthdate": "1990-01-01",
 - "address": {
- "street": "Rua do Alecrim",
 - "number": "S/N",
 - "country": "BR",
 - "state": "SP",
 - "zipCode": 45002100,
 - "city": "São Paulo",
 - "complement": "string",
 - "neighborhood": "Jardim São Paulo"
 
} 
}, - "refundedDate": "2019-08-24T14:15:22Z",
 - "refundedAmount": 500,
 - "capturedDate": "2019-08-24T14:15:22Z",
 - "createdAt": "2019-08-24T14:15:22Z",
 - "metadata": {
- "paymentId": "aa205f8b-2b1d-4a02-875f-a19fbb14325c",
 - "returnCode": "6",
 - "returnMessage"": "Operation Successful",
 - "autorizationCode": "175766"
 
} 
} 
]Faz uma cobrança através de cartão de crédito.
| amount required  | string  O valor da transacão em centavos. Ex.: R$10 = 1000  | 
| customCode | string  Código personalizado da plataforma.  | 
| isGift | boolean  Define se a compra é um presente ou não.  | 
required  | object (CustomerCreditCardRequest)    | 
required  | object   | 
| softDescriptor | string  Texto impresso na fatura bancaria comprador.  | 
{- "amount": "1000",
 - "customCode": "my-code",
 - "isGift": false,
 - "customer": {
- "name": "FULANO DE TAL",
 - "documentNumber": "12345678901",
 - "email": "foo@bar.com",
 - "phoneNumber": 11123451234,
 - "birthdate": "1990-01-01",
 - "customerSince": "2022-03-20T08:37:40.000Z",
 - "address": {
- "street": "Rua do Alecrim",
 - "number": "S/N",
 - "country": "BR",
 - "state": "SP",
 - "zipCode": 45002100,
 - "city": "São Paulo",
 - "complement": "string",
 - "neighborhood": "Jardim São Paulo"
 
} 
}, - "card": {
- "cvv": "123",
 - "number": "1234567812345678",
 - "holder": "FULANO DE TAL",
 - "expirationDate": "12/2022",
 - "brand": "mastercard",
 - "token": "c5a5929b-b967-4782-a9db-93af6334ee95"
 
}, - "softDescriptor": "my-code"
 
}{- "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
 - "amount": 1000,
 - "status": "paid",
 - "provider": "cielo",
 - "customer": {
- "name": "FULANO DE TAL",
 - "email": "foo@bar.com",
 - "phoneNumber": 11123451234,
 - "birthdate": "1990-01-01",
 - "address": {
- "street": "Rua do Alecrim",
 - "number": "S/N",
 - "country": "BR",
 - "state": "SP",
 - "zipCode": 45002100,
 - "city": "São Paulo",
 - "complement": "string",
 - "neighborhood": "Jardim São Paulo"
 
} 
}, - "capturedDate": "2019-08-24T14:15:22Z",
 - "metadata": {
- "paymentId": "aa205f8b-2b1d-4a02-875f-a19fbb14325c",
 - "returnCode": "6",
 - "returnMessage"": "Operation Successful",
 - "autorizationCode": "175766"
 
} 
}Um POST para a URL cadastrada em nossos sistema será enviado toda vez que houver uma alteração de status na transação
object   | 
{- "event": {
- "type": "debitCard",
 - "createdAt": "2019-08-24T14:15:22Z",
 - "data": {
- "debitCard": {
- "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
 - "amount": 1000,
 - "status": "paid",
 - "provider": "cielo",
 - "customer": {
- "name": "FULANO DE TAL",
 - "email": "foo@bar.com",
 - "phoneNumber": 11123451234,
 - "birthdate": "1990-01-01",
 - "address": {
- "street": "Rua do Alecrim",
 - "number": "S/N",
 - "country": "BR",
 - "state": "SP",
 - "zipCode": 45002100,
 - "city": "São Paulo",
 - "complement": "string",
 - "neighborhood": "Jardim São Paulo"
 
} 
}, - "refundedDate": "2019-08-24T14:15:22Z",
 - "refundedAmount": 500,
 - "capturedDate": "2019-08-24T14:15:22Z",
 - "metadata": {
- "paymentId": "aa205f8b-2b1d-4a02-875f-a19fbb14325c",
 - "returnCode": "6",
 - "returnMessage"": "Operation Successful",
 - "autorizationCode": "175766"
 
} 
} 
} 
} 
}Pesquisa uma trancação por ID.
| id required  | string  ID da transação.  | 
{- "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
 - "amount": 1000,
 - "status": "paid",
 - "provider": "cielo",
 - "customer": {
- "name": "FULANO DE TAL",
 - "email": "foo@bar.com",
 - "phoneNumber": 11123451234,
 - "birthdate": "1990-01-01",
 - "address": {
- "street": "Rua do Alecrim",
 - "number": "S/N",
 - "country": "BR",
 - "state": "SP",
 - "zipCode": 45002100,
 - "city": "São Paulo",
 - "complement": "string",
 - "neighborhood": "Jardim São Paulo"
 
} 
}, - "refundedDate": "2019-08-24T14:15:22Z",
 - "refundedAmount": 500,
 - "capturedDate": "2019-08-24T14:15:22Z",
 - "metadata": {
- "paymentId": "aa205f8b-2b1d-4a02-875f-a19fbb14325c",
 - "returnCode": "6",
 - "returnMessage"": "Operation Successful",
 - "autorizationCode": "175766"
 
} 
}Faz um cancelamento / estorno de uma transação.
| id required  | string  ID da transação.  | 
| amount | integer  Valor do estorno.  | 
{- "amount": 500
 
}{- "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
 - "amount": 1000,
 - "status": "refunded",
 - "provider": "cielo",
 - "customer": {
- "name": "FULANO DE TAL",
 - "email": "foo@bar.com",
 - "phoneNumber": 11123451234,
 - "birthdate": "1990-01-01",
 - "address": {
- "street": "Rua do Alecrim",
 - "number": "S/N",
 - "country": "BR",
 - "state": "SP",
 - "zipCode": 45002100,
 - "city": "São Paulo",
 - "complement": "string",
 - "neighborhood": "Jardim São Paulo"
 
} 
}, - "refundedDate": "2019-08-24T14:15:22Z",
 - "refundedAmount": 500,
 - "capturedDate": "2019-08-24T14:15:22Z",
 - "metadata": {
- "paymentId": "aa205f8b-2b1d-4a02-875f-a19fbb14325c",
 - "returnCode": "6",
 - "returnMessage"": "Operation Successful",
 - "autorizationCode": "175766"
 
} 
}Pesquisa uma transação por customCode.
| customCode | string  
  | 
[- {
- "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
 - "amount": 1000,
 - "status": "paid",
 - "provider": "cielo",
 - "customer": {
- "name": "FULANO DE TAL",
 - "email": "foo@bar.com",
 - "phoneNumber": 11123451234,
 - "birthdate": "1990-01-01",
 - "address": {
- "street": "Rua do Alecrim",
 - "number": "S/N",
 - "country": "BR",
 - "state": "SP",
 - "zipCode": 45002100,
 - "city": "São Paulo",
 - "complement": "string",
 - "neighborhood": "Jardim São Paulo"
 
} 
}, - "refundedDate": "2019-08-24T14:15:22Z",
 - "refundedAmount": 500,
 - "capturedDate": "2019-08-24T14:15:22Z",
 - "metadata": {
- "paymentId": "aa205f8b-2b1d-4a02-875f-a19fbb14325c",
 - "returnCode": "6",
 - "returnMessage"": "Operation Successful",
 - "autorizationCode": "175766"
 
} 
} 
]Faz uma cobrança através de cartão de débito. Caso a propriedade returnUrl não seja informada e o webhook estiver configurado para o cliente, uma notificação será enviada para o webhook configurado. Veja a seção de notificação para mais detalhes.
| amount required  | string  O valor da transacão em centavos. Ex.: R$10 = 1000  | 
| customCode | string  Código personalizado da plataforma.  | 
| isGift | boolean  Define se a compra é um presente ou não.  | 
required  | object (CustomerCreditCardRequest)    | 
required  | object   | 
| returnUrl | string  URL para pagamento através do browser.  | 
{- "amount": "1000",
 - "customCode": "my-code",
 - "isGift": false,
 - "customer": {
- "name": "FULANO DE TAL",
 - "documentNumber": "12345678901",
 - "email": "foo@bar.com",
 - "phoneNumber": 11123451234,
 - "birthdate": "1990-01-01",
 - "customerSince": "2022-03-20T08:37:40.000Z",
 - "address": {
- "street": "Rua do Alecrim",
 - "number": "S/N",
 - "country": "BR",
 - "state": "SP",
 - "zipCode": 45002100,
 - "city": "São Paulo",
 - "complement": "string",
 - "neighborhood": "Jardim São Paulo"
 
} 
}, - "card": {
- "cvv": "123",
 - "number": "1234567812345678",
 - "holder": "FULANO DE TAL",
 - "expirationDate": "12/2022",
 - "brand": "mastercard",
 - "token": "c5a5929b-b967-4782-a9db-93af6334ee95"
 
}, - "returnUrl": "string"
 
}{- "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
 - "amount": 1000,
 - "status": "paid",
 - "provider": "cielo",
 - "customer": {
- "name": "FULANO DE TAL",
 - "email": "foo@bar.com",
 - "phoneNumber": 11123451234,
 - "birthdate": "1990-01-01",
 - "address": {
- "street": "Rua do Alecrim",
 - "number": "S/N",
 - "country": "BR",
 - "state": "SP",
 - "zipCode": 45002100,
 - "city": "São Paulo",
 - "complement": "string",
 - "neighborhood": "Jardim São Paulo"
 
} 
}, - "refundedDate": "2019-08-24T14:15:22Z",
 - "refundedAmount": 500,
 - "capturedDate": "2019-08-24T14:15:22Z",
 - "metadata": {
- "paymentId": "aa205f8b-2b1d-4a02-875f-a19fbb14325c",
 - "returnCode": "6",
 - "returnMessage"": "Operation Successful",
 - "autorizationCode": "175766"
 
}, - "redirectUrl": "string"
 
}Retorna informações da transação
id a ser informado pode ser o id do cliente ou
id de transação do gateway| id required  | string   Example:  order1234 OR 8a9d35b5-33d9-4a94-b580-218ab4188fe8  | 
{- "id": "ae64fd9e-33f7-4ad0-950e-88ff394a01c9",
 - "customCode": "order123",
 - "amount": 1000,
 - "amountPaid": 1000,
 - "status": "paid",
 - "createdAt": "2019-08-24T14:15:22Z",
 - "paidAt": "2019-08-24T14:15:22Z",
 - "provider": "pinbank",
 - "type": "bankslip",
 - "customer": {
- "name": "FULANO DE TAL",
 - "email": "foo@bar.com",
 - "phoneNumber": 11123451234,
 - "birthdate": "1990-01-01",
 - "address": {
- "street": "Rua do Alecrim",
 - "number": "S/N",
 - "country": "BR",
 - "state": "SP",
 - "zipCode": 45002100,
 - "city": "São Paulo",
 - "complement": "string",
 - "neighborhood": "Jardim São Paulo"
 
} 
}, - "metadata": {
- "dueDate": "2019-08-24T14:15:22Z",
 - "referenceCode": "09/00001483936-7",
 - "digitableLine": "09390.00105 90000.148636 09000.000100 6 83610000001000"
 
} 
}Realiza uma consulta de status para o(s) pagamento(s) de boleto com o customCode.
[- {
- "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
 - "amount": 100,
 - "status": "pending",
 - "provider": "gerencianet",
 - "metadata": {
- "paymentId": "472e651e-5a1e-424d-8098-23858bf03ad7"
 
}, - "createdAt": "2019-08-24T14:15:22Z"
 
} 
]Realiza uma consulta de status para o pagamento com o ID informado.
{- "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
 - "amount": 100,
 - "status": "pending",
 - "provider": "gerencianet",
 - "metadata": {
- "paymentId": "472e651e-5a1e-424d-8098-23858bf03ad7"
 
}, - "createdAt": "2019-08-24T14:15:22Z"
 
}Pagar uma conta de boleto com código de barras.
| amount | number  O valor do boleto em centavos. Ex.: R$10 = 1000  | 
| barcode | string  Código de barras a ser pago.  | 
| customCode | string  Código personalizado da aplicação.  | 
{- "amount": 1000,
 - "barcode": "0000000000000000000000000000000000",
 - "customCode": "codigo-personalizado"
 
}{- "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
 - "amount": 1000,
 - "status": "pending"
 
}