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==
basic
Cria 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"
}