API para Emissão de Boletos e Cobrança Recorrente por Cartão de Crédito

API para Emissão de Boletos e Cobrança Recorrente por Cartão de Crédito

Introdução

Bem-vindo ao cel_cash!

São muitas as vantagens que o cel_cash tem disponível para revolucionar a cobrança da sua empresa. Para tornar este caminho mais fácil, iremos oferecer mais uma grande ajuda: abaixo você conhecerá o Manual de Integração da sua empresa com a API do cel_cash que permitirá o uso das melhores soluções de cobrança do mercado.

Para que a nossa parceria atenda-o de forma satisfatória e segura, o cel_cash oferece diferentes soluções seguras para captura de transações. As recomendações de cada etapa baixo, devem ser lidas com atenção e usadas como guia de referência para dúvidas que possam surgir no momento da implementação da integração em sua plataforma.

O conteúdo deste Manual de Integração é direcionado a programadores e desenvolvedores que desejam realizar a captura e o processamento de suas transações diretamente com o cel_cash.

O desenvolvedor/analista terá acesso a todos os passos e processos referentes à integração com o sistema de captura e autorização de transações financeiras do cel_cash via as funcionalidades da API.

Antes de apresentá-los as funcionalidades desta API, mais uma dica: sugerimos que periodicamente e sempre que for iniciado um desenvolvimento relacionado à captura de transações, utilize este portal para acompanhamento de mudanças e versionamento dos produtos de nossa plataforma.

IPs dos servidores de produção:
54.232.59.251
54.232.204.133

IPs dos servidores de sandbox:
54.207.173.93
Esses IPs podem ser alterados sem aviso prévio.

Funcionalidades

Com nossa API você terá a possibilidade de ter o nosso sistema integrado com o seu. Todas as ações necessárias para que você integre seu sistema com o nosso estão disponíveis para implementação. A integração permite que você crie um cliente no nosso sistema e até consulte o status do pagamento, se já foi pago ou não.

Disponibilizamos os métodos e dados de teste para que você consiga realizar a integração com nosso sistema sem riscos. Após a contratação e solicitação de credenciais, iremos encaminhar um e-mail com os credenciais de sua empresas para a integração funcionar em ambiente de produção.
Fluxo básico de integração
Fluxo de integração

Parceiros

Para identificarmos que a transação partiu de determinado parceiro, envie nas requisições o header "PartnerId" com o galaxId do parceiro.

Dados de teste

Login no sistema de teste (clique aqui para acessar)
Login: [email protected]
Senha: webservice@

Chaves de autenticação de teste:
URL: https://app.sandbox.cel.cash/
galaxId: 5473
galaxHash: 83Mw5u8988Qj6fZqS4Z8K7LzOo1j28S706R0BeFe

Dados de produção

Após a finalização da integração utilizando as chaves de autenticação de teste, entre dentro do sistema do cel_cash, e solicite pelo formulário de "Ajuda" as chaves de autenticações de produção.
URL: https://celcash.celcoin.com.br/

Dados de cartão

Operadora Cartão Validade Cvv Resultado
Cielo 4556 4181 2420 6784 12/2024 Qualquer Capturado
Cielo 4024 0071 5039 4517 12/2024 Qualquer Negado
Bin 4556 4181 2420 6784 12/2024 Qualquer Capturado
Bin 4024 0071 5039 4517 12/2023 Qualquer Negado
GetNet 5155 9012 2228 0001 12/2024 Qualquer Capturado
GetNet 5155 9012 2227 0002 12/2024 Qualquer Negado
Global Payments 4548 8120 4940 0004 12/2024 Qualquer Capturado
Global Payments 4916 9296 2589 6753 12/2024 Qualquer Negado
Rede 4761 1200 0000 0148 01/2020 123 Capturado
Rede 4761 1200 0000 0148 12/2024 Qualquer Negado
Zoop 4539 0033 7072 5497 Qualquer Qualquer Capturado
Zoop 4929 7104 2663 7678 Qualquer Qualquer Negado
PagSeguro 4111 1111 1111 1111 Qualquer Qualquer Capturado
PagSeguro 4242 4242 4242 4242 Qualquer Qualquer Negado
GetNet Gateway 5447 3188 7939 1031 02/2024 528 Capturado
GetNet Gateway 6370 9509 2478 2803 Qualquer Qualquer Negado

Utilize as chaves de autenticação de teste e os cartões abaixo para simular um pagamento com o resultado esperado.
Os cartões citados irão ter o resultado esperado apenas no ambiente de testes.

Status das transações

Abaixo estão listados os status disponíveis para uma transação.
Status Descrição
notSend Ainda não enviada para operadora de Cartão
authorized Autorizado
captured Capturada na Operadora de Cartão
denied Negada na Operadora de Cartão
reversed Estornada na Operadora de Cartão
pendingBoleto Boleto em aberto
payedBoleto Boleto compensado
moreValueBoleto Boleto pago valor maior que o original
lessValueBoleto Boleto pago valor menor que o original
notCompensated Boleto baixado por decurso de prazo
pendingPix Pix em aberto
payedPix Pix pago
unavailablePix Pix indisponível para pagamento
cancel Cancelada manualmente
payExternal Paga fora do sistema
cancelByContract Cancelada ao cancelar a cobrança
free Isento

Cliente

Área destinada para as transações de Contratos/Vendas. Você conseguirá retornar todas as transações necessárias em uma lista, estornar uma transação, cancelar uma transação, visualizar uma lista contendo todos os status de transações disponíveis para seu sistema, dentre outras funcionalidades.Etapa 1

/createCustomer

Área destinada ao cadastro dos dados de um novo cliente, podendo ou não conter o endereço do cliente.

Parâmetros

integrationId
string
255 caracteres
ID de integração utilizado para relacionar seu sistema com o cel_cash.
ID do cliente no seu sistema
Exemplo: "1".
document
string
255 caracteres
Obrigatorio
Documento (CPF ou CNPJ ou RNE no caso de estrangeiros)
Exemplo: "012.345.678-90".
name
string
255 caracteres
Obrigatorio
Nome
Exemplo: "Teste cliente do cel_cash API".
email
string
255 caracteres
Obrigatorio
E-mail de contato
Exemplo: "[email protected]".
phone
string
13 caracteres
Telefone ou celular para contato
Exemplo: "(31)4020-1512".
cellphone
string
14 caracteres
Celular
Exemplo: "(31)98585-8585".
password
string
255 caracteres
Senha do cliente para login externo
Exemplo: "123456".
holdIss
bool
Retém ISS?
Apenas quando ativo o módulo de "Nota fiscal" e o documento CNPJ.
Exemplo: "true".
isForeign
bool
Se informado como "true", o cliente será cadastrado como estrangeiro
Exemplo: "true".
municipalInscription
string
255 caracteres
Inscrição Municipal
Apenas quando ativo o módulo de "Nota fiscal" e o documento CNPJ.
Exemplo: "123456".
Address
Endereço de cobrança do cliente.
zipCode
string
8 caracteres
CEP
Exemplo: "30411-325".
street
string
255 caracteres
Logradouro
Exemplo: "Rua platina".
number
integer
255 caracteres
Número
Exemplo: "1375".
neighborhood
string
255 caracteres
Bairro
Exemplo: "Prado".
city
string
255 caracteres
Cidade
Exemplo: "Belo Horizonte".
state
string
2 caracteres
Estado
Exemplo: "MG".
complement
string
255 caracteres
Complemento
Exemplo: "2º andar".
countryInitials
string
255 caracteres
Sigla ISO-3 do país de origem do cliente. Veja a lista aqui. Esse campo só deve ser informado caso o campo "isForeign" seja "true" e se torna obrigatório.
Exemplo: "BRA".

NOTAS

1 - O parametro "password" é obrigatório caso o módulo de senha para cliente externo esteja ativo.
2 - Caso informado o parametro "Address", todos os campos de endereço, exceto o "complement", serão obrigatorios.
3 - Para cadastrar Contratos/Vendas de boleto para o cliente, informe o endereço completo.
4 - Caso informado o parametro "holdIss" para um cliente que possui CNPJ, ao cadastrar um novo Contrato/Venda com emissão de NFS-e, irá alterar o valor da transação retirando a taxa de ISS que será paga pelo pagador.
post
https://app.sandbox.cel.cash/webservice/createCustomer
{ "Auth": { "galaxId": "5473", "galaxHash": "83Mw5u8988Qj6fZqS4Z8K7LzOo1j28S706R0BeFe" } ,"Request": {"integrationId": "1","document": "012.345.678-90","name": "Teste cliente do cel_cash API","email": "[email protected]","phone": "(31)4020-1512"} }
{"type":"true","customerInternalId":"1308","message":"Cliente cadastrado com sucesso"}

/updateCustomer

Atualiza os dados enviados do cliente.

Parâmetros

customerInternalId
string
255 caracteres
ID do cliente no cel_cash.
Exemplo: "1".
customerIntegrationId
string
255 caracteres
ID de integração utilizado para relacionar seu sistema com o cel_cash.
ID do cliente no seu sistema.
Exemplo: "1".
document
string
255 caracteres
Obrigatorio
Documento, podendo ser CPF ou CNPJ.
Exemplo: "012.345.678-90".
name
string
255 caracteres
Obrigatorio
Nome.
Exemplo: "Teste cliente do cel_cash".
email
string
255 caracteres
Obrigatorio
E-mail de contato.
Exemplo: "[email protected]".
phone
string
13 caracteres
Obrigatorio
Telefone ou celular para contato
Exemplo: "(31)4020-1512".
cellphone
string
14 caracteres
Celular,com o nono digito.
Exemplo: "(31)98585-8585".
password
string
255 caracteres
Senha do cliente para login externo.
Exemplo: "123456".
isForeign
bool
Se informado como "true", o cliente será alterado como estrangeiro
Exemplo: "true".
integrationId
string
255 caracteres
ID de integração utilizado para relacionar seu sistema com o cel_cash.
ID do cliente no seu sistema.
Exemplo: "1".
Address
Endereço de cobrança do cliente.
zipCode
string
8 caracteres
Obrigatorio
CEP.
Exemplo: "30411-325".
street
string
255 caracteres
Obrigatorio
Logradouro.
Exemplo: "Rua platina".
number
integer
255 caracteres
Obrigatorio
Número.
Exemplo: "1375".
neighborhood
string
255 caracteres
Obrigatorio
Bairro.
Exemplo: "Prado".
city
string
255 caracteres
Obrigatorio
Cidade.
Exemplo: "Belo Horizonte".
state
string
2 caracteres
Obrigatorio
Estado.
Exemplo: "MG".
complement
string
255 caracteres
Complemento.
Exemplo: "2º andar".
countryInitials
string
255 caracteres
Sigla ISO-3 do país de origem do cliente. Veja a lista aqui. Esse campo só deve ser informado caso o campo "isForeign" seja "true" e se torna obrigatório.
Exemplo: "BRA".

NOTAS

5 - É obrigatório apenas um dos dois parâmetros citados (customerInternalId, customerIntegrationId). Somente um destes parâmetros é considerado, logo, os mesmos estão em ordem de relevância.
6 - O parâmetro "customerInternalId" não irá ser alterado caso informado, o restante sim.
7 - Informe apenas os parametros que deseja alterar.
post
https://app.sandbox.cel.cash/webservice/updateCustomer
{ "Auth": { "galaxId": "5473", "galaxHash": "83Mw5u8988Qj6fZqS4Z8K7LzOo1j28S706R0BeFe" } ,"Request": {"customerIntegrationId": "1","document": "012.345.678-90","name": "Teste cliente do cel_cash","email": "[email protected]","phone": "(31)4020-1512","cellphone": "(31)98585-8585","Address": {"zipCode": "30411-325","street": "Rua platina","number": "1375","neighborhood": "Prado","city": "Belo Horizonte","state": "MG","complement": "2º andar","countryInitials": "BRA"}} }
{"type":"true","message":"Cliente alterado com sucesso"}

/getCustomerInfo

Retorna todas as informações referente ao cliente desejado, que pode ser filtrado por diferentes parâmetros.

Parâmetros

customerInternalId
integer
11 caracteres
ID do cliente no cel_cash.
Exemplo: "1".
customerIntegrationId
string
255 caracteres
ID de integração informado ao cadastrar o cliente pelo parâmetros "integrationId".
ID do cliente no seu sistema.
Exemplo: "1".
customerDocument
string
16 caracteres
CPF/CNPJ do cliente.
Exemplo: "012.345.678-90".
customerEmail
string
255 caracteres
Email do cliente.
Exemplo: "[email protected]".

NOTAS

8 - É obrigatório o uso de apenas um dos quatro parâmetros citados acima.
9 - Somente um destes parâmetros será considerado e por isso, estão citados acima por ordem de relevância.
post
https://app.sandbox.cel.cash/webservice/getCustomerInfo
{ "Auth": { "galaxId": "5473", "galaxHash": "83Mw5u8988Qj6fZqS4Z8K7LzOo1j28S706R0BeFe" } ,"Request": {"customerInternalId": "1"} }
{"type": "true","customer": {"internalId": "123","integrationId": "123","document": "01234567890","name": "Testes Construsite","email": "[email protected]","phone": "(23)4234-23423","cellphone": "(23)9423-23423","isForeign":"false","Address": {"street": "Rua Platina","number": "1375","complement": "2° Andar","neighborhood": "Prado","city": "Belo Horizonte","state": "MG","zipCode": "30411325","countryInitials":"null"}}}

/verifyPasswordCustomer

Retorna se a senha enviada está em conformidade com a senha cadastrada no sistema.
Utilizado somente para clientes que possuirem o módulo de senha para cliente ativo.

Parâmetros

customerInternalId
integer
11 caracteres
ID do cliente no cel_cash.
Exemplo: "1".
customerIntegrationId
string
255 caracteres
ID de integração, informado ao cadastrar o cliente pelo parâmetros "integrationId".
ID do cliente no seu sistema.
Exemplo: "1".
customerEmail
string
255 caracteres
Email do cliente.
Exemplo: "[email protected]".
password
string
Obrigatorio
Senha do cliente para verificação.
Exemplo: "123456".

NOTAS

10 - É obrigatório apenas um dos três parâmetros citados (customerInternalId, customerIntegrationId, customerEmail). Somente um destes parâmetros é considerado, logo, os mesmos estão em ordem de relevância.
post
https://app.sandbox.cel.cash/webservice/verifyPasswordCustomer
{ "Auth": { "galaxId": "5473", "galaxHash": "83Mw5u8988Qj6fZqS4Z8K7LzOo1j28S706R0BeFe" } ,"Request": {"customerEmail": "[email protected]","password": "123456"} }
{"type":"true","message":"Senha correta."}

/getCustomers

Retorna todas as informações de clientes de acordo com o filtro de data escolhido.

Parâmetros

startDate
date
Obrigatorio
Data de início do filtro
Exemplo: "2020-05-10".
endDate
date
Obrigatorio
Data final do filtro
Exemplo: "2020-05-15".
typeDate
string
Obrigatorio
Tipo de filtro com as datas informadas
Exemplo: "dateCreatedAt".

Opções

Opções disponiveis para uso em "typeDate"
Valor Descrição
dateCreatedAt Data em que o cliente foi inserido
dateOfLastUpdate Data em que o cliente foi atualizado
both Data em que o cliente foi inserido ou atualizado
post
https://app.sandbox.cel.cash/webservice/getCustomers
{ "Auth": { "galaxId": "5473", "galaxHash": "83Mw5u8988Qj6fZqS4Z8K7LzOo1j28S706R0BeFe" } ,"Request": {"startDate": "2020-05-10","endDate": "2020-05-15","typeDate": "dateCreatedAt"} }
{"type":true,"quantity":1,"customers":[{"internalId":"1","integrationId":"","document":"01234567890","name":"cel_cash Teste","email":"[email protected]","phone":"(31) 4020-1512","cellphone":"(31) 98787-8787","isForeign":"false","insertdate":"2020-05-15 08:49:59","updatedate":"2020-05-15 08:49:59","Address":{"street":"Rua Monte Alverne","number":"","complement":null,"neighborhood":"Floresta","city":"Belo Horizonte","state":"MG","zipCode":"31015400","countryInitials":"null"},"CustomFields":{"CP_CAMPO_PERSONALIZADO_CLIENTE":"Teste cel_cash Data de Nascimento","CP_CAMPO_PERSONALIZADO_CLIENTE1":"Teste cel_cash"}}]}

Planos

Área destinada a métodos dos planos, você conseguirá visualizar todos os planos e seus preços até apenas um único plano.

/createPlan

Área destinada ao cadastro de planos.

Parâmetros

integrationId
string
255 caracteres
Obrigatorio
ID do plano utilizado para relacionar seu sistema com o cel_cash.
ID do plano no seu sistema.
Exemplo: "1".
name
string
255 caracteres
Obrigatorio
Nome do plano
Exemplo: "Plano mensal básico".
periodicity
string
Obrigatorio
Periodicidade do Plano.
Exemplo: "monthly".

Opções

Opções disponiveis para uso em "periodicity"
Valor Descrição
single Única(Venda)
weekly Semanal
biweekly Quinzenal
monthly Mensal
bimonthly Bimestral
quarterly Trimestral
biannual Semestral
yearly Anual
manual Manual
quantity
string
Quantidade de parcelas.
Para parcelas indeterminadas informe "indeterminated".
Informar apenas quando o campo "periodicity" não for igual "single".

Exemplo: "12".
values
Obrigatorio
Valores de cada método de pagamento
debit
string
255 caracteres
Valor do débito para o plano.
Válido somente quando a "periodicity" for "single".
Exemplo: "50.00".
boleto
string
255 caracteres
Valor do boleto para o plano
Exemplo: "45.00".
credit
string
255 caracteres
Valor do cŕedito para o plano.
Exemplo para valor único:
"50.00".
Exemplo para valores diferentes por parcela:
{"1": "51.00","2": "52.00","3": "53.00"}

Exemplo: "50.00".
contract
string
Contrato digital a ser aceito pelo cliente ao contratar o plano.
Para o cliente aceitar este contrato deverá estar ativo o módulo de
"Contrato digital" em seu sistema.
additionalInfo
string
Observações sobre o plano, apenas para controle interno no sistema.

NOTAS

11 - Caso a periodicidade seja "Manual", o cel_cash não irá gerar nenhuma transação, sendo necessário utilizar o endpoint /addTransactionContract.
12 - Os métodos de pagamento disponíveis para utilizar no parâmetro "values" pode ser obtido utilizando o resultado do método "/getPaymentTypesEnabled".
post
https://app.sandbox.cel.cash/webservice/createPlan
{ "Auth": { "galaxId": "5473", "galaxHash": "83Mw5u8988Qj6fZqS4Z8K7LzOo1j28S706R0BeFe" } ,"Request": {"integrationId": "1","name": "Plano mensal básico","periodicity": "monthly","quantity": "12","values": {"credit": "50.00"}} }
{"type":"true","message":"Plano cadastrado com sucesso."}

/getAllPlansActive

Retorna uma lista contendo todos os planos ativos e seus preços.
Este método não necessita de parâmetros na requisição.
post
https://app.sandbox.cel.cash/webservice/getAllPlansActive
{ "Auth": { "galaxId": "5473", "galaxHash": "83Mw5u8988Qj6fZqS4Z8K7LzOo1j28S706R0BeFe" } }
{"type":"true","plans":[{"internalId":"11","integrationId":"23","name":"Plano de exemplo 1","planType":"contract","periodicity":"monthly","periodicityDescription":"Mensal","quantity":"5","initialPrice":"100.00","priceList":{"credit":[{"price":"100.00","installment":"1"}]}},{"internalId":"52","integrationId":"","name":"Plano de exemplo 2","planType":"sale","periodicity":"monthly","periodicityDescription":"Mensal","quantity":"2","initialPrice":"100.00","priceList":{"credit":[{"price":"100.00","installment":"1"},{"price":"100.00","installment":"2"}],"boleto":[{"price":"100.00","installment":"1"}]}},{"internalId":"63","integrationId":"23","name":"Plano de exemplo 3","planType":"contract","periodicity":"monthly","periodicityDescription":"Mensal","quantity":"4","initialPrice":"100.00","priceList":{"boleto":[{"price":"100.00","installment":"1"}]}}]}

/getPlansByIds

Retorna uma lista contendo todos os planos ativos e seus preços filtrados pelos IDs que foram informados.Os índices "credit" e "boleto"

Parâmetros

ids
string
IDs dos planos no cel_cash
Exemplo: "11,52,63".
integrationIds
string
IDs de integração dos planos no cel_cash
Exemplo: "120C,541T,636R".

NOTAS

13 - É obrigatório apenas um dos dois parâmetros citados (ids, integrationIds).
Somente um destes parâmetros é considerado, logo, os mesmos estão em ordem de relevância.
14 - Separe o IDs por vírgula, conforme o exemplo.
post
https://app.sandbox.cel.cash/webservice/getPlansByIds
{ "Auth": { "galaxId": "5473", "galaxHash": "83Mw5u8988Qj6fZqS4Z8K7LzOo1j28S706R0BeFe" } ,"Request": {"ids": "11,52,63"} }
{"type":"true","plans":[{"internalId":"11","integrationId":"23","name":"Plano de exemplo 1","planType":"contract","periodicity":"monthly","periodicityDescription":"Mensal","quantity":"5","initialPrice":"100.00","priceList":{"credit":[{"price":"100.00","installment":"1"}]}},{"internalId":"52","integrationId":"","name":"Plano de exemplo 2","planType":"sale","periodicity":"monthly","periodicityDescription":"Mensal","quantity":"2","initialPrice":"100.00","priceList":{"credit":[{"price":"100.00","installment":"1"},{"price":"100.00","installment":"2"}],"boleto":[{"price":"100.00","installment":"1"}]}},{"internalId":"63","integrationId":"23","name":"Plano de exemplo 3","planType":"contract","periodicity":"monthly","periodicityDescription":"Mensal","quantity":"4","initialPrice":"100.00","priceList":{"boleto":[{"price":"100.00","installment":"1"}]}}]}

Cartões

Área destinada aos métodos dos clientes. Você conseguirá visualizar uma lista de informações sobre os cartões cadastrados para determinado cliente, poderá receber uma lista contendo todas as bandeiras disponíveis para determinada operadora, dentre outras funcionalidades.

/createCard

Área destinada ao cadastro do cartão para determinado cliente.

Parâmetros

customerInternalId
string
255 caracteres
ID do cliente no cel_cash.
Exemplo: "1".
customerIntegrationId
string
255 caracteres
ID de integração informado ao cadastrar o cliente pelo parâmetros "integrationId".
ID do cliente no seu sistema.
Exemplo: "1".
Card
Dados do cartão do cliente.
integrationId
string
255 caracteres
ID de integração informado ao cadastrar um cartão.
ID do cartão no seu sistema.
Exemplo: "1".
number
string
255 caracteres
Número do cartão.
Exemplo: "4716 0248 9944 1650".
holder
string
30 caracteres
Nome do portador do cartão (Nome no cartão).
Exemplo: "Cliente de exemplo cel_cash".
expiryMonth
integer
2 caracteres
Mês de expiração do cartão.
Exemplo: "04".
expiryYear
integer
4 caracteres
Ano de expiração do cartão.
Exemplo: "2023".
cvv
integer
4 caracteres
Código de segurança do cartão.
Exemplo: "541".
brand
string
36 caracteres
Bandeira do cartão
Exemplo: "visa".

NOTAS

15 - A bandeira do cartão para utilizar no parâmetro "brand" pode ser obtido utilizando o resultado do método "/getCardBrandsByOperator".
post
https://app.sandbox.cel.cash/webservice/createCard
{ "Auth": { "galaxId": "5473", "galaxHash": "83Mw5u8988Qj6fZqS4Z8K7LzOo1j28S706R0BeFe" } ,"Request": {"customerInternalId": "1","Card": {"integrationId": "1","number": "4716 0248 9944 1650","holder": "Cliente de exemplo cel_cash","expiryMonth": "04","expiryYear": "2023","cvv": "541","brand": "visa"}} }
{"type":"true","cardInternalId":"1308","message":"Cliente cadastrado com sucesso"}

/getCardsByCustomer

Retorna uma lista contendo as informações de todos os cartões cadastrados para determinado cliente, podendo ser filtrado por diferentes parâmetros.

Parâmetros

customerIntegrationId
string
255 caracteres
ID de integração informado ao cadastrar o cliente pelo parâmetro "integrationId".
ID do cliente no seu sistema.
Exemplo: "1".
customerInternalId
integer
11 caracteres
ID do cliente no cel_cash.
Exemplo: "1".

NOTAS

16 - É obrigatório o uso de apenas um dos parâmetros citados acima.
post
https://app.sandbox.cel.cash/webservice/getCardsByCustomer
{ "Auth": { "galaxId": "5473", "galaxHash": "83Mw5u8988Qj6fZqS4Z8K7LzOo1j28S706R0BeFe" } ,"Request": {"customerIntegrationId": "1"} }
{"type": "true","cards": [{"integrationId": "123","internalId": "123","truncatedNumber": "455187******0183","brand": "Visa"}]}

/getCardBrandsByOperator

Retorna uma lista das bandeiras disponíveis para uso de determinada operadora. Cada bandeira irá possuir um limite de parcelas disponíveis para uso no parcelamento.

Parâmetros

operatorName
string
255 caracteres
Obrigatorio
Nome da operadora que deseja coletar as bandeiras disponíveis.
Exemplo: "cielo".

NOTAS

17 - O nome da operadora para utilizar no parâmetro "operatorName" pode ser obtido utilizando o resultado do método "/getOperatorList".
post
https://app.sandbox.cel.cash/webservice/getCardBrandsByOperator
{ "Auth": { "galaxId": "5473", "galaxHash": "83Mw5u8988Qj6fZqS4Z8K7LzOo1j28S706R0BeFe" } ,"Request": {"operatorName": "cielo"} }
{"type": "true","brands": [{"name": "visa","displayName": "Visa","maxNumberOfInstallments": "12"}]}

/getBrandCard

Retorna a bandeira do cartão.

Parâmetros

cardNumber
string
255 caracteres
Obrigatorio
Número do cartão
Exemplo: "4539 4044 6689 9859".
post
https://app.sandbox.cel.cash/webservice/getBrandCard
{ "Auth": { "galaxId": "5473", "galaxHash": "83Mw5u8988Qj6fZqS4Z8K7LzOo1j28S706R0BeFe" } ,"Request": {"cardNumber": "4539 4044 6689 9859"} }
{"type":"true","brand":[{"internalName":"visa","name":"Visa"}]}

/getAllBrandsEnabled

Retorna todas as bandeiras disponiveis.
Este método não necessita de parâmetros na requisição.
post
https://app.sandbox.cel.cash/webservice/getAllBrandsEnabled
{ "Auth": { "galaxId": "5473", "galaxHash": "83Mw5u8988Qj6fZqS4Z8K7LzOo1j28S706R0BeFe" } }
{"type":"true","brands":[{"internalName":"visa","name":"Visa"},{"internalName":"mastercard","name":"MasterCard"},{"internalName":"diners","name":"Diners"},{"internalName":"discover","name":"Discover"},{"internalName":"elo","name":"Elo"},{"internalName":"amex","name":"Amex"},{"internalName":"aura","name":"Aura"},{"internalName":"hipercard","name":"Hipercard"},{"internalName":"jcb","name":"JCB"}]}

/getMaxInstallmentByBrand

Retorna o limite máximo de vezes disponível para determinada bandeira.

Parâmetros

brandInternalName
string
255 caracteres
Obrigatorio
Nome interno da bandeira
Exemplo: "visa".
post
https://app.sandbox.cel.cash/webservice/getMaxInstallmentByBrand
{ "Auth": { "galaxId": "5473", "galaxHash": "83Mw5u8988Qj6fZqS4Z8K7LzOo1j28S706R0BeFe" } ,"Request": {"brandInternalName": "visa"} }
{"type":"true","maxInstallment":"15"}

Operadoras

Área destinada a métodos das operadoras de cobranças. Você conseguirá uma lista de operadoras disponíveis para realizar pagamentos em seu sistema, dentre outras funcionalidades.

/getOperatorList

Retorna uma lista de todas as operadoras disponíveis para realizar pagamentos. O resultado retornado poderá ser utilizado em outros métodos da API.
Este método não necessita de parâmetros na requisição.
post
https://app.sandbox.cel.cash/webservice/getOperatorList
{ "Auth": { "galaxId": "5473", "galaxHash": "83Mw5u8988Qj6fZqS4Z8K7LzOo1j28S706R0BeFe" } }
{"type": "true","operators": [{"name": "cielo","displayName": "Cielo"}]}

/getPaymentTypesEnabled

Retorna uma lista de todas os métodos de pagamentos disponíveis para realizar pagamentos. O resultado retornado poderá ser utilizado em outros métodos da API.
Este método não necessita de parâmetros na requisição.
post
https://app.sandbox.cel.cash/webservice/getPaymentTypesEnabled
{ "Auth": { "galaxId": "5473", "galaxHash": "83Mw5u8988Qj6fZqS4Z8K7LzOo1j28S706R0BeFe" } }
{"type":"true","paymentMethods":[{"displayName":"Débito","name":"debit"},{"displayName":"Crédito","name":"credit"},{"displayName":"Boleto","name":"boleto"}]}

Contratos/Vendas

Área destinada a Contratos/Vendas do sistema. Você conseguirá criar cobranças de vários tipos para seus clientes, uma lista de cobranças por cliente, realizar o cancelamento de um Contrato/Venda, alterar um cartão de um Contrato/Venda para realizar uma nova tentativa de cobrança, dentre outras funcionalidades.Etapa 2

/createPaymentBill

Área destinada ao cadastro de um novo Contrato/Venda para realizar a cobrança em um cartão de crédito ou débito. Este novo Contrato/Venda poderá ser configurado de diferentes formas.

Parâmetros

integrationId
string
255 caracteres
ID do Contrato/Venda utilizado para relacionar seu sistema com o cel_cash.
ID do contrato/venda no seu sistema.
Exemplo: "1".
customerInternalId
integer
11 caracteres
ID do cliente no cel_cash.
Exemplo: "1".
customerIntegrationId
string
255 caracteres
ID de integração informado ao cadastrar o cliente pelo parâmetro "integrationId".
Exemplo: "1".
planInternalId
string
ID interno do plano no sistema.
Exemplo: "1".
planIntegrationId
string
ID para integração do plano.
Exemplo: "12321A".
typeBill
string
Obrigatorio
Tipo da cobrança a ser cadastrada.
Exemplo: "sale".

Opções

Opções disponiveis para uso em "typeBill"
Valor Descrição
contract Contrato
sale Venda
periodicity
string
Periodicidade do Contrato.
Utilizada somente quando o typeBill ser "contract".
Exemplo: "monthly".

Opções

Opções disponiveis para uso em "periodicity"
Valor Descrição
weekly Semanal
biweekly Quinzenal
monthly Mensal
bimonthly Bimestral
quarterly Trimestral
biannual Semestral
yearly Anual
manual Manual
payday
date
YYYY-mm-dd
Obrigatorio
Data de pagamento da 1ª transação.
Exemplo: "2018-06-21".
value
decimal
Obrigatorio
Valor do Contrato/Venda.
Exemplo: "80.00".
minNumberOfInstallments
integer
11 caracteres
Número mínimo de parcelas.
Utilizada somente quando o typeBill ser "sale" e o paymentType ser "link".
Exemplo: "2".
numberOfInstallments
integer
11 caracteres
Obrigatorio
Número máximo de parcelas.
Utilizada somente quando o typeBill ser "sale".
Exemplo: "2".
quantity
string
Quantidade de transações. Caso a cobrança seja indeterminada informe "indeterminated".
Utilizada somente quando o typeBill ser "contract".
Exemplo: "4".
paymentType
string
Obrigatorio
Ação para realizar o cadastro de "Contrato/Venda".
Exemplo: "newCard".

Opções

Opções disponiveis para uso em "paymentType"
Valor Descrição
newCard Para pagamento com um cartão novo, informe dentro de “Card” os dados do cartão.
existingCard Para pagamento com um cartão existente, informe dentro de "Card" o "integrationId" OU o "internalId".
link Para pagamento com link externo não é necessário informar "Card" pois o mesmo não será considerado.
payed Para cadastrar com uma transação já paga. Caso seja um contrato, apenas a primeira transação ficará com o status "Paga fora do sistema". Não é necessário informar "Card" pois o mesmo não será considerado.
preAuthorize
bool
Apenas pré autorizar as transações e posteriormente capturá-las com o endpoint "captureTransaction". Caso não seja informado, a transação será capturada.
Exemplo: "true".
payDate
date
YYYY-mm-dd
Utilizado apenas se o "paymentType" for "payed". Use esse campo para informar a data do pagamento. Caso não informado, irá utilizar a data de cadastro do contrato/venda.
Exemplo: "2018-06-21".
operator
string
Nome da operadora que deseja realizar a cobrança.
Exemplo: "cielo".
additionalInfo
string
255 caracteres
Observações sobre o Contrato/Venda, apenas para controle interno no sistema.
Exemplo: "Contrato/Venda X5A2145A".
integrationIds
ID de cada transação utilizado para relacionar seu sistema com o cel_cash.
Irá ser aplicado o integrationId somente nas transações informadas, as demais transações irão ficar vazias.

Informe a transação que deseja aplicar o desconto pelo número da parcela.
Exemplo: se quer informar o integrationId na terceira transação informe "3"
Válido para ser utilizado apenas com o campo "typeBill" igual a "contract".
1
string
255 caracteres
ID da primeira transação no seu sistema.
Exemplo: "{"integrationId": "123456@"}".
2
string
255 caracteres
ID da segunda transação no seu sistema.
Exemplo: "{"integrationId": "9875a8@"}".
discounts
Valor de desconto para cada transação. Irá ser aplicado o desconto somente nas transações informadas, as demais transações irão ficar com o valor do Contratos.

Informe a transação que deseja aplicar o desconto pelo número da parcela.
Exemplo: se quer aplicar desconto na terceira transação informe "3".
1
string
255 caracteres
Informações sobre o desconto da primeira transação.
Exemplo: "{"valueDiscount": "10.00", "info": "Desconto da primeira mensalidade"}".
2
string
255 caracteres
Informações sobre o desconto da segunda transação.
Exemplo: "{"valueDiscount": "10.00"}".
Card
Dados do cartão do cliente.
integrationId
string
255 caracteres
ID de integração informado ao cadastrar um cartão.
ID do cartão no seu sistema.
Exemplo: "1".
number
string
255 caracteres
Número do cartão.
Exemplo: "4716 0248 9944 1650".
holder
string
30 caracteres
Nome do portador do cartão (Nome no cartão).
Exemplo: "Cliente de exemplo cel_cash".
expiryMonth
integer
2 caracteres
Mês de expiração do cartão.
Exemplo: "04".
expiryYear
integer
4 caracteres
Ano de expiração do cartão.
Exemplo: "2023".
cvv
integer
4 caracteres
Código de segurança do cartão.
Exemplo: "541".
brand
string
36 caracteres
Bandeira do cartão
Exemplo: "visa".
Invoice
Informações necessárias a serem informadas para a geração de nota fiscal
isToGenerate
bool
Obrigatorio
Utilizado para informar se é para gerar nota fiscal.
Exemplo: "true".
type
string
255 caracteres
Obrigatorio
Utilizado para informar como as notas fiscais irão ser geradas.
Exemplo: "uniqueNf".

Opções

Opções disponiveis para uso em "type"
Valor Descrição
uniqueNf Gerar uma única nota fiscal para a venda.
transactionsNf Gerar uma nota fiscal para cada parcela (transação).
moment
string
255 caracteres
Obrigatorio
Momento da emissão de nota fiscal.
Exemplo: "afterpay".

Opções

Opções disponiveis para uso em "moment"
Valor Descrição
create Ao cadastrar transação (transações parceladas somente após o pagamento)
notification No momento do envio do boleto (envio da notificação)
before Dias antes do vencimento da transação
afterpay Após transação ser paga
daysBeforePayday
string
Dias antes para Emissão.
Somente para o momento de emissão da nota "Dias antes do vencimento da transação".
Exemplo: "3".
subAccountBilling
integer
11 caracteres
ID da subconta para emissão da nota fiscal. Caso não informado, será emitido para a conta principal.
Exemplo: "1532".
Obrigatorio
descriptions
Descrição das transações para a geração de nota fiscal.
Caso não seja informado a descrição especifica da transação, iremos aplicar a ela o que foi informado na última descrição.
1
string
255 caracteres

Exemplo: "{"info": "NF primeira mensalidade"}".
2
string
255 caracteres

Exemplo: "{"info": "NF segunda mensalidade"}".
CustomFields
Informações para serem salvas dentro dos campos personalizados configurados dentro do sistema.
Deve ser utilizado a TAG gerada para campo personalizado dentro do sistema.
CP_FILIAL
string
Valor correspondente a ser salvo no campo personalizado de filial.
Exemplo: "Belo horizonte".
CP_FILIAL_NUMERO
string
Valor correspondente a ser salvo no campo personalizado de número da filial.
Exemplo: "21514".
Antifraud
Dados de analise do antifraude.
sessionId
string
255 caracteres
Obrigatorio
Código único do usuário logado no sistema do seu e-commerce.
Exemplo: "65a7e35f4a6s7dfa46a78sd".
ipCustomer
string
255 caracteres
Obrigatorio
IP do computador do cliente que esta realizando a compra.
Exemplo: "195.113.54.21".

NOTAS

18 - Caso a periodicidade seja "Manual", o cel_cash não irá gerar nenhuma transação, sendo necessário utilizar o endpoint /addTransactionContract.
19 - O nome da operadora para utilizar no parâmetro "operator" pode ser obtido utilizando o resultado do método "/getOperatorList".
20 - A bandeira do cartão para utilizar no parâmetro "brand" pode ser obtido utilizando o resultado do método "/getCardBrandsByOperator".
21 - Caso não for informado o parâmetro "operator", irá obedecer a prioridade de operadoras do sistema, somente se o "paymentType" for igual a "newCard".
22 - Caso sejam informados algum dos parâmetros do plano(planInternalId, planIntegrationId) somente um será considerado.
23 - O campo "discounts" é aplicado somente a Contratos do typo "contract".
24 - É obrigatório apenas um dos quatro parâmetros citados (customerInternalId, customerIntegrationId). Somente um destes parâmetros é considerado, logo, os mesmos estão em ordem de relevância.
25 - O parâmetro "Invoice" deverá ser informado apenas quando desejar gerar notas fiscais.
26 - O parâmetro "CustomFields" deverá ser informado apenas quando deseja registrar informações nos campos personalizados dos sistema.
27 - Caso seja informado que irá ser gerado nota fiscal e o cliente retenha ISS, os valores informados irão descontar o valor correspondente ao ISS automáticamente.
post
https://app.sandbox.cel.cash/webservice/createPaymentBill
{ "Auth": { "galaxId": "5473", "galaxHash": "83Mw5u8988Qj6fZqS4Z8K7LzOo1j28S706R0BeFe" } ,"Request": {"integrationId": "1","customerIntegrationId": "1","typeBill": "sale","payday": "2018-06-21","value": "80.00","numberOfInstallments": "2","paymentType": "newCard","Card": {"integrationId": "1","number": "4716 0248 9944 1650","holder": "Cliente de exemplo cel_cash","expiryMonth": "04","expiryYear": "2023","cvv": "541","brand": "visa"}} }
{"type": "true","paymentBillInternalId":"1245","message": "Contrato/Venda cadastrado com sucesso."}

/createPaymentBillAndCustomer

Área destinada ao cadastro ou alteração de um cliente e cadastro de um Contrato/Venda para realizar a cobrança em um cartão de crédito ou débito. Este novo Contrato/Venda poderá ser configurado de diferentes formas.

Parâmetros

integrationId
string
255 caracteres
ID do Contrato/Venda utilizado para relacionar seu sistema com o cel_cash.
ID do contrato/venda no seu sistema.
Exemplo: "1".
planInternalId
string
ID interno do plano no sistema.
Exemplo: "1".
planIntegrationId
string
ID para integração do plano.
Exemplo: "12321A".
typeBill
string
Obrigatorio
Tipo da cobrança a ser cadastrada.
Exemplo: "sale".

Opções

Opções disponiveis para uso em "typeBill"
Valor Descrição
contract Contrato
sale Venda
periodicity
string
Periodicidade do Contrato.
Utilizada somente quando o typeBill ser "contract".
Exemplo: "monthly".

Opções

Opções disponiveis para uso em "periodicity"
Valor Descrição
weekly Semanal
biweekly Quinzenal
monthly Mensal
bimonthly Bimestral
quarterly Trimestral
biannual Semestral
yearly Anual
manual Manual
payday
date
YYYY-mm-dd
Obrigatorio
Data de pagamento da 1ª transação.
Exemplo: "2018-06-21".
value
decimal
Obrigatorio
Valor do Contrato/Venda.
Exemplo: "80.00".
minNumberOfInstallments
integer
11 caracteres
Número mínimo de parcelas.
Utilizada somente quando o typeBill ser "sale" e o paymentType ser "link".
Exemplo: "2".
numberOfInstallments
integer
11 caracteres
Obrigatorio
Número de parcelas.
Utilizada somente quando o typeBill ser "sale".
Exemplo: "4".
quantity
string
Quantidade de transações. Caso a cobrança seja indeterminada informe "indeterminated".
Utilizada somente quando o typeBill ser "contract".
Exemplo: "4".
paymentType
string
Obrigatorio
Ação para realizar o cadastro de "Contrato/Venda".
Exemplo: "newCard".

Opções

Opções disponiveis para uso em "paymentType"
Valor Descrição
newCard Para pagamento com um cartão novo, informe dentro de “Card” os dados do cartão.
existingCard Para pagamento com um cartão existente, informe dentro de "Card" o "integrationId" OU o "internalId".
link Para pagamento com link externo não é necessário informar "Card" pois o mesmo não será considerado.
payed Para cadastrar com uma transação já paga. Caso seja um contrato, apenas a primeira transação ficará com o status "Paga fora do sistema". Não é necessário informar "Card" pois o mesmo não será considerado.
preAuthorize
bool
Apenas pré autorizar as transações e posteriormente capturá-las com o endpoint "captureTransaction". Caso não seja informado, a transação será capturada.
Exemplo: "true".
payDate
date
YYYY-mm-dd
Utilizado apenas se o "paymentType" for "payed". Use esse campo para informar a data do pagamento. Caso não informado, irá utilizar a data de cadastro do contrato/venda.
Exemplo: "2018-06-21".
operator
string
Nome da operadora que deseja realizar a cobrança.
Exemplo: "cielo".
additionalInfo
string
255 caracteres
Observações sobre o Contrato/Venda, apenas para controle interno no sistema.
Exemplo: "Contrato/Venda X5A2145A".
integrationIds
ID de cada transação utilizado para relacionar seu sistema com o cel_cash.
Irá ser aplicado o integrationId somente nas transações informadas, as demais transações irão ficar vazias.

Informe a transação que deseja aplicar o desconto pelo número da parcela.
Exemplo: se quer informar o integrationId na terceira transação informe "3"
Válido para ser utilizado apenas com o campo "typeBill" igual a "contract".
1
string
255 caracteres
ID da primeira transação no seu sistema.
Exemplo: "{"integrationId": "123456@"}".
2
string
255 caracteres
ID da segunda transação no seu sistema.
Exemplo: "{"integrationId": "9875a8@"}".
discounts
Valor de desconto para cada transação. Irá ser aplicado o desconto somente nas transações informadas, as demais transações irão ficar com o valor do Contratos.

Informe a transação que deseja aplicar o desconto pelo número da parcela.
Exemplo: se quer aplicar desconto na terceira transação informe "3".
1
string
255 caracteres
Informações sobre o desconto da primeira transação.
Exemplo: "{"valueDiscount": "10.00", "info": "Desconto da primeira mensalidade"}".
2
string
255 caracteres
Informações sobre o desconto da segunda transação.
Exemplo: "{"valueDiscount": "10.00"}".
Customer
Informações do cliente a ser cadastrado ou alterado e que possuirá o Contrato/Venda.
integrationId
string
255 caracteres
ID de integração utilizado para relacionar seu sistema com o cel_cash.
ID do cliente no seu sistema
Exemplo: "1".
document
string
255 caracteres
Obrigatorio
Documento (CPF ou CNPJ)
Exemplo: "012.345.678-90".
name
string
255 caracteres
Obrigatorio
Nome
Exemplo: "Teste cliente do cel_cash".
email
string
255 caracteres
Obrigatorio
E-mail de contato
Exemplo: "[email protected]".
phone
string
13 caracteres
Telefone ou celular para contato
Exemplo: "(31)4020-1512".
cellphone
string
14 caracteres
Celular
Exemplo: "(31)98585-8585".
password
string
255 caracteres
Senha do cliente para login externo
Exemplo: "123456".
holdIss
bool
Retém ISS?
Apenas quando ativo o módulo de "Nota fiscal" e o documento CNPJ.
Exemplo: "true".
isForeign
bool
Se informado como "true", o cliente será cadastrado como estrangeiro
Exemplo: "true".
municipalInscription
string
255 caracteres
Inscrição Municipal
Apenas quando ativo o módulo de "Nota fiscal" e o documento CNPJ.
Exemplo: "123456".
Address
Endereço de cobrança do cliente.
zipCode
string
8 caracteres
CEP
Exemplo: "30411-325".
street
string
255 caracteres
Logradouro
Exemplo: "Rua platina".
number
integer
255 caracteres
Número
Exemplo: "1375".
neighborhood
string
255 caracteres
Bairro
Exemplo: "Prado".
city
string
255 caracteres
Cidade
Exemplo: "Belo Horizonte".
state
string
2 caracteres
Estado
Exemplo: "MG".
complement
string
255 caracteres
Complemento
Exemplo: "2º andar".
countryInitials
string
255 caracteres
Sigla ISO-3 do país de origem do cliente. Veja a lista aqui. Esse campo só deve ser informado caso o campo "isForeign" seja "true" e se torna obrigatório.
Exemplo: "BRA".
Card
Dados do cartão do cliente.
integrationId
string
255 caracteres
ID de integração informado ao cadastrar um cartão.
ID do cartão no seu sistema.
Exemplo: "1".
number
string
255 caracteres
Número do cartão.
Exemplo: "4716 0248 9944 1650".
holder
string
30 caracteres
Nome do portador do cartão (Nome no cartão).
Exemplo: "Cliente de exemplo cel_cash".
expiryMonth
integer
2 caracteres
Mês de expiração do cartão.
Exemplo: "04".
expiryYear
integer
4 caracteres
Ano de expiração do cartão.
Exemplo: "2023".
cvv
integer
4 caracteres
Código de segurança do cartão.
Exemplo: "541".
brand
string
36 caracteres
Bandeira do cartão
Exemplo: "visa".
Invoice
Informações necessárias a serem informadas para a geração de nota fiscal
isToGenerate
bool
Obrigatorio
Utilizado para informar se é para gerar nota fiscal.
Exemplo: "true".
type
string
255 caracteres
Obrigatorio
Utilizado para informar como as notas fiscais irão ser geradas.
Exemplo: "uniqueNf".

Opções

Opções disponiveis para uso em "type"
Valor Descrição
uniqueNf Gerar uma única nota fiscal para a venda.
transactionsNf Gerar uma nota fiscal para cada parcela (transação).
moment
string
255 caracteres
Obrigatorio
Momento da emissão de nota fiscal.
Exemplo: "afterpay".

Opções

Opções disponiveis para uso em "moment"
Valor Descrição
create Ao cadastrar transação (transações parceladas somente após o pagamento)
notification No momento do envio do boleto (envio da notificação)
before Dias antes do vencimento da transação
afterpay Após transação ser paga
daysBeforePayday
string
Dias antes para Emissão.
Somente para o momento de emissão da nota "Dias antes do vencimento da transação".
Exemplo: "3".
subAccountBilling
integer
11 caracteres
ID da subconta para emissão da nota fiscal. Caso não informado, será emitido para a conta principal.
Exemplo: "1532".
Obrigatorio
descriptions
Descrição das transações para a geração de nota fiscal.
Caso não seja informado a descrição especifica da transação, iremos aplicar a ela o que foi informado na última descrição.
1
string
255 caracteres

Exemplo: "{"info": "NF primeira mensalidade"}".
2
string
255 caracteres

Exemplo: "{"info": "NF segunda mensalidade"}".
CustomFields
Informações para serem salvas dentro dos campos personalizados configurados dentro do sistema.
Deve ser utilizado a TAG gerada para campo personalizado dentro do sistema.
CP_FILIAL
string
Valor correspondente a ser salvo no campo personalizado de filial.
Exemplo: "Belo horizonte".
CP_FILIAL_NUMERO
string
Valor correspondente a ser salvo no campo personalizado de número da filial.
Exemplo: "21514".
Antifraud
Dados de analise do antifraude.
sessionId
string
255 caracteres
Obrigatorio
Código único do usuário logado no sistema do seu e-commerce.
Exemplo: "65a7e35f4a6s7dfa46a78sd".
ipCustomer
string
255 caracteres
Obrigatorio
IP do computador do cliente que esta realizando a compra.
Exemplo: "195.113.54.21".

NOTAS

28 - Caso a periodicidade seja "Manual", o cel_cash não irá gerar nenhuma transação, sendo necessário utilizar o endpoint /addTransactionContract.
29 - O nome da operadora para utilizar no parâmetro "operator" pode ser obtido utilizando o resultado do método "/getOperatorList".
30 - A bandeira do cartão para utilizar no parâmetro "brand" pode ser obtido utilizando o resultado do método "/getCardBrandsByOperator".
31 - Caso não for informado o parâmetro "operator", irá obedecer a prioridade de operadoras do sistema, somente se o "paymentType" for igual a "newCard".
32 - Caso sejam informados algum dos parâmetros do plano(planInternalId, planIntegrationId) somente um será considerado.
33 - O campo "discounts" é aplicado somente a Contratos do typo "contract".
34 - É obrigatório apenas um dos quatro parâmetros citados (customerInternalId, customerIntegrationId). Somente um destes parâmetros é considerado, logo, os mesmos estão em ordem de relevância.
35 - O parametro "password" é obrigatório caso o módulo de senha para cliente externo esteja ativo.
36 - Caso informado o parametro "Address", todos os campos de endereço, exceto o "complement", serão obrigatorios.
37 - O parâmetro "Invoice" deverá ser informado apenas quando desejar gerar notas fiscais.
38 - O parâmetro "CustomFields" deverá ser informado apenas quando deseja registrar informações nos campos personalizados dos sistema.
39 - Caso seja informado que irá ser gerado nota fiscal e o cliente retenha ISS, os valores informados irão descontar o valor correspondente ao ISS automáticamente.
40 - Caso informado o parametro "holdIss" para um cliente que possui CNPJ, ao cadastrar um novo Contrato/Venda com emissão de NFS-e, irá alterar o valor da transação retirando a taxa de ISS que será paga pelo pagador.
post
https://app.sandbox.cel.cash/webservice/createPaymentBillAndCustomer
{ "Auth": { "galaxId": "5473", "galaxHash": "83Mw5u8988Qj6fZqS4Z8K7LzOo1j28S706R0BeFe" } ,"Request": {"integrationId": "1","typeBill": "sale","payday": "2018-06-21","value": "80.00","numberOfInstallments": "4","paymentType": "newCard","Customer": {"integrationId": "1","document": "012.345.678-90","name": "Teste cliente do cel_cash","email": "[email protected]","phone": "(31)4020-1512","Address": {"zipCode": "30411-325","street": "Rua platina","number": "1375","neighborhood": "Prado","city": "Belo Horizonte","state": "MG","complement": "2º andar","countryInitials": "BRA"}},"Card": {"integrationId": "1","number": "4716 0248 9944 1650","holder": "Cliente de exemplo cel_cash","expiryMonth": "04","expiryYear": "2023","cvv": "541","brand": "visa"}} }
{"type": "true","paymentBillInternalId":"1245","message": "Contrato/Venda cadastrado com sucesso."}

/createPaymentBillBoleto

Área destinada ao cadastro de um novo Contrato/Venda para realizar cobranças com boletos. Este novo Contrato/Venda poderá ser configurado de diferentes formas.

Parâmetros

integrationId
string
255 caracteres
ID do Contrato/Venda utilizado para relacionar seu sistema com o cel_cash.
ID do contrato/venda no seu sistema.
Exemplo: "1".
typeBill
string
Obrigatorio
Tipo da cobrança a ser cadastrada.
Exemplo: "contract".

Opções

Opções disponiveis para uso em "typeBill"
Valor Descrição
contract Contrato
sale Venda
paymentType
string
255 caracteres
Utilizado para cadastrar a primeira transação como paga. Único valor disponível é "payed"
Exemplo: "payed".

Opções

Opções disponiveis para uso em "paymentType"
Valor Descrição
payed Para cadastrar com uma transação já paga. Caso seja um contrato, apenas a primeira transação ficará com o status "Paga fora do sistema".
payDate
date
YYYY-mm-dd
Utilizado apenas quando o "paymentType" for "payed". Use esse campo para informar a data do pagamento. Caso não informado, irá utilizar a data de cadastro do contrato/venda.
Exemplo: "2018-06-21".
periodicity
string
Periodicidade do Contrato.
Exemplo: "monthly".

Opções

Opções disponiveis para uso em "periodicity"
Valor Descrição
weekly Semanal
biweekly Quinzenal
monthly Mensal
bimonthly Bimestral
quarterly Trimestral
biannual Semestral
yearly Anual
manual Manual
payday
date
YYYY-mm-dd
Obrigatorio
Data de pagamento da 1ª transação.
Exemplo: "2018-06-21".
value
decimal
Obrigatorio
Valor do Contrato/Venda.
Exemplo: "80.00".
quantity
string
Obrigatorio
Quantidade de transações. Caso a cobrança seja indeterminada informe "indeterminated".
Exemplo: "4".
customerIntegrationId
string
255 caracteres
Obrigatorio
ID de integração informado ao cadastrar o cliente pelo parâmetro "integrationId".
ID do cliente no seu sistema.
Exemplo: "1".
integrationIds
ID de cada transação utilizado para relacionar seu sistema com o cel_cash.
Irá ser aplicado o integrationId somente nas transações informadas, as demais transações irão ficar vazias.

Informe a transação que deseja aplicar o desconto pelo número da parcela.
Exemplo: se quer informar o integrationId na terceira transação informe "3"
Válido para ser utilizado apenas com o campo "typeBill" igual a "contract".
1
string
255 caracteres
ID da primeira transação no seu sistema.
Exemplo: "{"integrationId": "123456@"}".
2
string
255 caracteres
ID da segunda transação no seu sistema.
Exemplo: "{"integrationId": "9875a8@"}".
discounts
Valor de desconto para cada transação. Irá ser aplicado o desconto somente nas transações informadas, as demais transações irão ficar com o valor do Contratos.

Informe a transação que deseja aplicar o desconto pelo número da parcela.
Exemplo: se quer aplicar desconto na terceira transação informe "3".
1
string
255 caracteres
Informações sobre o desconto da primeira transação.
Exemplo: "{"valueDiscount": "10.00", "info": "Desconto da primeira mensalidade"}".
2
string
255 caracteres
Informações sobre o desconto da segunda transação.
Exemplo: "{"valueDiscount": "10.00"}".
planInternalId
string
ID interno do plano no sistema.
Exemplo: "1".
planIntegrationId
string
ID para integração do plano.
Exemplo: "12321A".
fineBoleto
decimal
36 caracteres
Porcentagem de multa por atraso.
Exemplo: "2.50".
interestBoleto
decimal
36 caracteres
Porcentagem de juros ao mês.
Exemplo: "1.25".
infoBoleto
string
255 caracteres
Observações do boleto, irá ser acrescentado na área de "Instruções" do boleto. Para quebrar linha utilize "\n", sendo que será exibido no máximo 3 linhas.
Exemplo: "Cobrança referente ao servico de manutenção de computadores".
typeConditionalDiscount
decimal
36 caracteres
Tipo do desconto condicional a ser aplicado
Exemplo: "percent".

Opções

Opções disponiveis para uso em "typeConditionalDiscount"
Valor Descrição
percent Percentual (%)
fixed Valor Fixo (R$)
daysBeforePayDayDiscount
string
36 caracteres
Quantidade de dias que o desconto será válido
Exemplo: "5".

Opções

Opções disponiveis para uso em "daysBeforePayDayDiscount"
Valor Descrição
0 Até a data de vencimento
1 Até 1 dia antes da data de vencimento
2 Até 2 dias antes da data de vencimento
3 Até 3 dias antes da data de vencimento
4 Até 4 dias antes da data de vencimento
5 Até 5 dias antes da data de vencimento
6 Até 6 dias antes da data de vencimento
7 Até 7 dias antes da data de vencimento
8 Até 8 dias antes da data de vencimento
9 Até 9 dias antes da data de vencimento
10 Até 10 dias antes da data de vencimento
11 Até 11 dias antes da data de vencimento
12 Até 12 dias antes da data de vencimento
13 Até 13 dias antes da data de vencimento
14 Até 14 dias antes da data de vencimento
15 Até 15 dias antes da data de vencimento
conditionalDiscount
decimal
36 caracteres
Desconto a ser aplicado
Exemplo: "R$ 75,00 ou 75,50%".
Invoice
Informações necessárias a serem informadas para a geração de nota fiscal
isToGenerate
bool
Obrigatorio
Utilizado para informar se é para gerar nota fiscal.
Exemplo: "true".
type
string
255 caracteres
Obrigatorio
Utilizado para informar como as notas fiscais irão ser geradas.
Exemplo: "uniqueNf".

Opções

Opções disponiveis para uso em "type"
Valor Descrição
uniqueNf Gerar uma única nota fiscal para a venda.
transactionsNf Gerar uma nota fiscal para cada parcela (transação).
moment
string
255 caracteres
Obrigatorio
Momento da emissão de nota fiscal.
Exemplo: "afterpay".

Opções

Opções disponiveis para uso em "moment"
Valor Descrição
create Ao cadastrar transação (transações parceladas somente após o pagamento)
notification No momento do envio do boleto (envio da notificação)
before Dias antes do vencimento da transação
afterpay Após transação ser paga
daysBeforePayday
string
Dias antes para Emissão.
Somente para o momento de emissão da nota "Dias antes do vencimento da transação".
Exemplo: "3".
subAccountBilling
integer
11 caracteres
ID da subconta para emissão da nota fiscal. Caso não informado, será emitido para a conta principal.
Exemplo: "1532".
Obrigatorio
descriptions
Descrição das transações para a geração de nota fiscal.
Caso não seja informado a descrição especifica da transação, iremos aplicar a ela o que foi informado na última descrição.
1
string
255 caracteres

Exemplo: "{"info": "NF primeira mensalidade"}".
2
string
255 caracteres

Exemplo: "{"info": "NF segunda mensalidade"}".
CustomFields
Informações para serem salvas dentro dos campos personalizados configurados dentro do sistema.
Deve ser utilizado a TAG gerada para campo personalizado dentro do sistema.
CP_FILIAL
string
Valor correspondente a ser salvo no campo personalizado de filial.
Exemplo: "Belo horizonte".
CP_FILIAL_NUMERO
string
Valor correspondente a ser salvo no campo personalizado de número da filial.
Exemplo: "21514".

NOTAS

41 - Caso a periodicidade seja "Manual", o cel_cash não irá gerar nenhuma transação, sendo necessário utilizar o endpoint /addTransactionContract.
42 - Caso sejam informados algum dos parâmetros do plano(planInternalId, planIntegrationId) somente um será considerado.
43 - Os parâmetros "typeConditionalDiscount", "daysBeforePayDayDiscount" e "conditionalDiscount" serão utilizados apenas se o módulo "Desconto condicional por boleto" esteja ativo dentro do sistema.
44 - O campo "discounts" é aplicado somente a Contratos do typo "contract".
45 - O parâmetro "Invoice" deverá ser informado apenas quando desejar gerar notas fiscais.
46 - O parâmetro "CustomFields" deverá ser informado apenas quando deseja registrar informações nos campos personalizados dos sistema.
47 - Caso seja informado que irá ser gerado nota fiscal e o cliente retenha ISS, os valores informados irão descontar o valor correspondente ao ISS automáticamente.
post
https://app.sandbox.cel.cash/webservice/createPaymentBillBoleto
{ "Auth": { "galaxId": "5473", "galaxHash": "83Mw5u8988Qj6fZqS4Z8K7LzOo1j28S706R0BeFe" } ,"Request": {"integrationId": "1","typeBill": "contract","periodicity": "monthly","payday": "2018-06-21","value": "80.00","quantity": "4","customerIntegrationId": "1","fineBoleto": "2.50","interestBoleto": "1.25"} }
{"type": "true","paymentBillInternalId":"1245","message": "Contrato/Venda cadastrado com sucesso."}

/createPaymentBillBoletoAndCustomer

Área destinada ao cadastro ou alteração de um cliente e cadastro de um Contrato/Venda para realizar cobranças com boletos. Este novo Contrato/Venda poderá ser configurado de diferentes formas.

Parâmetros

integrationId
string
255 caracteres
ID do Contrato/Venda utilizado para relacionar seu sistema com o cel_cash.
ID do contrato/venda no seu sistema.
Exemplo: "1".
typeBill
string
Obrigatorio
Tipo da cobrança a ser cadastrada.
Exemplo: "contract".

Opções

Opções disponiveis para uso em "typeBill"
Valor Descrição
contract Contrato
sale Venda
paymentType
string
255 caracteres
Utilizado para cadastrar a primeira transação como paga. Único valor disponível é "payed"
Exemplo: "payed".

Opções

Opções disponiveis para uso em "paymentType"
Valor Descrição
payed Para cadastrar com uma transação já paga. Caso seja um contrato, apenas a primeira transação ficará com o status "Paga fora do sistema".
payDate
date
YYYY-mm-dd
Utilizado apenas quando o "paymentType" for "payed". Use esse campo para informar a data do pagamento. Caso não informado, irá utilizar a data de cadastro do contrato/venda.
Exemplo: "2018-06-21".
periodicity
string
Periodicidade do Contrato.
Exemplo: "monthly".

Opções

Opções disponiveis para uso em "periodicity"
Valor Descrição
weekly Semanal
biweekly Quinzenal
monthly Mensal
bimonthly Bimestral
quarterly Trimestral
biannual Semestral
yearly Anual
manual Manual
payday
date
YYYY-mm-dd
Obrigatorio
Data de pagamento da 1ª transação.
Exemplo: "2018-06-21".
value
decimal
Obrigatorio
Valor do Contrato/Venda.
Exemplo: "80.00".
quantity
string
Obrigatorio
Quantidade de transações. Caso a cobrança seja indeterminada informe "indeterminated".
Exemplo: "4".
integrationIds
ID de cada transação utilizado para relacionar seu sistema com o cel_cash.
Irá ser aplicado o integrationId somente nas transações informadas, as demais transações irão ficar vazias.

Informe a transação que deseja aplicar o desconto pelo número da parcela.
Exemplo: se quer informar o integrationId na terceira transação informe "3"
Válido para ser utilizado apenas com o campo "typeBill" igual a "contract".
1
string
255 caracteres
ID da primeira transação no seu sistema.
Exemplo: "{"integrationId": "123456@"}".
2
string
255 caracteres
ID da segunda transação no seu sistema.
Exemplo: "{"integrationId": "9875a8@"}".
discounts
Valor de desconto para cada transação. Irá ser aplicado o desconto somente nas transações informadas, as demais transações irão ficar com o valor do Contratos.

Informe a transação que deseja aplicar o desconto pelo número da parcela.
Exemplo: se quer aplicar desconto na terceira transação informe "3".
1
string
255 caracteres
Informações sobre o desconto da primeira transação.
Exemplo: "{"valueDiscount": "10.00", "info": "Desconto da primeira mensalidade"}".
2
string
255 caracteres
Informações sobre o desconto da segunda transação.
Exemplo: "{"valueDiscount": "10.00"}".
planInternalId
string
ID interno do plano no sistema.
Exemplo: "1".
planIntegrationId
string
ID para integração do plano.
Exemplo: "12321A".
fineBoleto
decimal
36 caracteres
Porcentagem de multa por atraso.
Exemplo: "2.50".
interestBoleto
decimal
36 caracteres
Porcentagem de juros ao mês.
Exemplo: "1.25".
infoBoleto
string
255 caracteres
Observações do boleto, irá ser acrescentado na área de "Instruções" do boleto. Para quebrar linha utilize "\n", sendo que será exibido no máximo 3 linhas.
Exemplo: "Cobrança referente ao servico de manutenção de computadores".
typeConditionalDiscount
decimal
36 caracteres
Tipo do desconto condicional a ser aplicado
Exemplo: "percent".

Opções

Opções disponiveis para uso em "typeConditionalDiscount"
Valor Descrição
percent Percentual (%)
fixed Valor Fixo (R$)
daysBeforePayDayDiscount
string
36 caracteres
Quantidade de dias que o desconto será válido
Exemplo: "5".

Opções

Opções disponiveis para uso em "daysBeforePayDayDiscount"
Valor Descrição
0 Até a data de vencimento
1 Até 1 dia antes da data de vencimento
2 Até 2 dias antes da data de vencimento
3 Até 3 dias antes da data de vencimento
4 Até 4 dias antes da data de vencimento
5 Até 5 dias antes da data de vencimento
6 Até 6 dias antes da data de vencimento
7 Até 7 dias antes da data de vencimento
8 Até 8 dias antes da data de vencimento
9 Até 9 dias antes da data de vencimento
10 Até 10 dias antes da data de vencimento
11 Até 11 dias antes da data de vencimento
12 Até 12 dias antes da data de vencimento
13 Até 13 dias antes da data de vencimento
14 Até 14 dias antes da data de vencimento
15 Até 15 dias antes da data de vencimento
conditionalDiscount
decimal
36 caracteres
Desconto a ser aplicado
Exemplo: "R$ 75,00 ou 75,50%".
Invoice
Informações necessárias a serem informadas para a geração de nota fiscal
isToGenerate
bool
Obrigatorio
Utilizado para informar se é para gerar nota fiscal.
Exemplo: "true".
type
string
255 caracteres
Obrigatorio
Utilizado para informar como as notas fiscais irão ser geradas.
Exemplo: "uniqueNf".

Opções

Opções disponiveis para uso em "type"
Valor Descrição
uniqueNf Gerar uma única nota fiscal para a venda.
transactionsNf Gerar uma nota fiscal para cada parcela (transação).
moment
string
255 caracteres
Obrigatorio
Momento da emissão de nota fiscal.
Exemplo: "afterpay".

Opções

Opções disponiveis para uso em "moment"
Valor Descrição
create Ao cadastrar transação (transações parceladas somente após o pagamento)
notification No momento do envio do boleto (envio da notificação)
before Dias antes do vencimento da transação
afterpay Após transação ser paga
daysBeforePayday
string
Dias antes para Emissão.
Somente para o momento de emissão da nota "Dias antes do vencimento da transação".
Exemplo: "3".
subAccountBilling
integer
11 caracteres
ID da subconta para emissão da nota fiscal. Caso não informado, será emitido para a conta principal.
Exemplo: "1532".
Obrigatorio
descriptions
Descrição das transações para a geração de nota fiscal.
Caso não seja informado a descrição especifica da transação, iremos aplicar a ela o que foi informado na última descrição.
1
string
255 caracteres

Exemplo: "{"info": "NF primeira mensalidade"}".
2
string
255 caracteres

Exemplo: "{"info": "NF segunda mensalidade"}".
Customer
Informações do cliente a ser cadastrado ou alterado e que possuirá o Contrato/Venda.
integrationId
string
255 caracteres
ID de integração utilizado para relacionar seu sistema com o cel_cash.
ID do cliente no seu sistema
Exemplo: "1".
document
string
255 caracteres
Obrigatorio
Documento (CPF ou CNPJ)
Exemplo: "012.345.678-90".
name
string
255 caracteres
Obrigatorio
Nome
Exemplo: "Teste cliente do cel_cash".
email
string
255 caracteres
Obrigatorio
E-mail de contato
Exemplo: "[email protected]".
phone
string
13 caracteres
Telefone ou celular para contato
Exemplo: "(31)4020-1512".
cellphone
string
14 caracteres
Celular
Exemplo: "(31)98585-8585".
password
string
255 caracteres
Senha do cliente para login externo
Exemplo: "123456".
holdIss
bool
Retém ISS?
Apenas quando ativo o módulo de "Nota fiscal" e o documento CNPJ.
Exemplo: "true".
isForeign
bool
Se informado como "true", o cliente será cadastrado como estrangeiro
Exemplo: "true".
municipalInscription
string
255 caracteres
Inscrição Municipal
Apenas quando ativo o módulo de "Nota fiscal" e o documento CNPJ.
Exemplo: "123456".
Address
Endereço de cobrança do cliente.
zipCode
string
8 caracteres
CEP
Exemplo: "30411-325".
street
string
255 caracteres
Logradouro
Exemplo: "Rua platina".
number
integer
255 caracteres
Número
Exemplo: "1375".
neighborhood
string
255 caracteres
Bairro
Exemplo: "Prado".
city
string
255 caracteres
Cidade
Exemplo: "Belo Horizonte".
state
string
2 caracteres
Estado
Exemplo: "MG".
complement
string
255 caracteres
Complemento
Exemplo: "2º andar".
countryInitials
string
255 caracteres
Sigla ISO-3 do país de origem do cliente. Veja a lista aqui. Esse campo só deve ser informado caso o campo "isForeign" seja "true" e se torna obrigatório.
Exemplo: "BRA".
CustomFields
Informações para serem salvas dentro dos campos personalizados configurados dentro do sistema.
Deve ser utilizado a TAG gerada para campo personalizado dentro do sistema.
CP_FILIAL
string
Valor correspondente a ser salvo no campo personalizado de filial.
Exemplo: "Belo horizonte".
CP_FILIAL_NUMERO
string
Valor correspondente a ser salvo no campo personalizado de número da filial.
Exemplo: "21514".

NOTAS

48 - Caso a periodicidade seja "Manual", o cel_cash não irá gerar nenhuma transação, sendo necessário utilizar o endpoint /addTransactionContract.
49 - Caso sejam informados algum dos parâmetros do plano(planInternalId, planIntegrationId) somente um será considerado.
50 - Os parâmetros "typeConditionalDiscount", "daysBeforePayDayDiscount" e "conditionalDiscount" serão utilizados apenas se o módulo "Desconto condicional por boleto" esteja ativo dentro do sistema.
51 - O campo "discounts" é aplicado somente a Contratos do typo "contract".
52 - O parâmetro "Invoice" deverá ser informado apenas quando desejar gerar notas fiscais.
53 - O parâmetro "CustomFields" deverá ser informado apenas quando deseja registrar informações nos campos personalizados dos sistema.
54 - Caso seja informado que irá ser gerado nota fiscal e o cliente retenha ISS, os valores informados irão descontar o valor correspondente ao ISS automáticamente.
55 - Caso informado o parametro "holdIss" para um cliente que possui CNPJ, ao cadastrar um novo Contrato/Venda com emissão de NFS-e, irá alterar o valor da transação retirando a taxa de ISS que será paga pelo pagador.
post
https://app.sandbox.cel.cash/webservice/createPaymentBillBoletoAndCustomer
{ "Auth": { "galaxId": "5473", "galaxHash": "83Mw5u8988Qj6fZqS4Z8K7LzOo1j28S706R0BeFe" } ,"Request": {"integrationId": "1","typeBill": "contract","periodicity": "monthly","payday": "2018-06-21","value": "80.00","quantity": "4","fineBoleto": "2.50","interestBoleto": "1.25","Customer": {"integrationId": "1","document": "012.345.678-90","name": "Teste cliente do cel_cash","email": "[email protected]","phone": "(31)4020-1512","Address": {"zipCode": "30411-325","street": "Rua platina","number": "1375","neighborhood": "Prado","city": "Belo Horizonte","state": "MG","complement": "2º andar","countryInitials": "BRA"}}} }
{"type": "true","paymentBillInternalId":"1245","message": "Contrato/Venda cadastrado com sucesso."}

/getPaymentBillInfo

Retorna todas as informações do pagamento e suas transações.

Parâmetros

internalId
integer
11 caracteres
ID do Contrato/Venda no cel_cash.
Exemplo: "1".
integrationId
string
255 caracteres
ID do Contrato/Venda que é utilizado para relacionar seu sistema com o cel_cash.
ID do Contrato/Venda no seu sistema.
Exemplo: "1".

NOTAS

56 - É obrigatório o uso de apenas um dos parâmetros citados acima.
57 - Caso a transação seja do tipo de boleto o RESPONSE do método retornará a URL do boleto e a linha digitável.
post
https://app.sandbox.cel.cash/webservice/getPaymentBillInfo
{ "Auth": { "galaxId": "5473", "galaxHash": "83Mw5u8988Qj6fZqS4Z8K7LzOo1j28S706R0BeFe" } ,"Request": {"internalId": "1"} }
{"type":true,"paymentBill":{"internalId":"1","integrationId":"","periodicity":"monthly","quantity":"6","dateFirst":"2020-05-15","status":"active","statusDescription":"Ativa","additionalInfo":null,"urlCarne":"https://data.galaxpay.com.br/testegalaxpay/carne/c3b17e535f11c02338a0d05db4ac9b0a","infoBoleto":"Referente ao pagamento da mensalidade","value":"50.00","customerInternalId":"1","customerIntegrationId":"","customerName":"cel_cash Teste","operator":"boletoGalaxPay","operatorName":"Boleto cel_cash","transactions":[{"internalId":"1","integrationId":null,"payday":"2020-05-15","installmentNumber":"1","additionalInfo":null,"customerInternalId":"1","customerIntegrationId":null,"paymentBillInternalId":"1","paymentBillIntegrationId":null,"paymentBillAdditionalInfo":null,"value":"50.00","lastUpdateDate":"2020-05-15 09:34:57","status":"pendingBoleto","statusDescription":"Em aberto","isBoleto":true,"boleto":"https://data.galaxpay.com.br/testegalaxpay/boleto/2020052PR6JHV2Z8EFQY1J7KLYCL0GF15093457","boletoBankLine":"03399022070600000001517232201016982560000005000","boletoBankNumber":"13485793TESTE-1172322249990985","boletoEmissionDate":"2020-05-15 09:34:57","boletoBankEmissor":"santander","qrCodePix":"ABC123ABC123ABC123ABC123ABC123ABC123ABC123ABC123ABC123ABC123ABC123","imageQrCodePix":"https://data.galaxpay.com.br/testegalaxpay/pix/13485793TESTE","pageQrCodePix":"https://gpay.com.br/q/5473/cce43a96"}]}}
{"type":true,"paymentBill":{"internalId":"2","integrationId":"","periodicity":"monthly","quantity":"5","dateFirst":"2020-05-15","status":"active","statusDescription":"Ativa","additionalInfo":null,"link":"https://app.galaxpay.com.br/testegalaxpay/cobranca/2/cartao","value":"50.00","brand":"Visa","cardTruncate":"4024********4517","customerInternalId":"1","customerIntegrationId":"","customerName":"cel_cash Teste","operator":"bin","operatorName":"BIN","transactions":[{"internalId":"7","integrationId":null,"payday":"2020-05-15","installmentNumber":"1","tid":null,"additionalInfo":null,"customerInternalId":"1","customerIntegrationId":null,"link":"https://app.galaxpay.com.br/testegalaxpay/cobranca/2/cartao","paymentBillInternalId":"2","paymentBillIntegrationId":null,"paymentBillAdditionalInfo":null,"value":"50.00","authorizationCode":"APROVADO89BIN90205","lastUpdateDate":"2020-05-15 09:48:43","status":"captured","statusDescription":"Capturada na Operadora","isBoleto":false,"brand":"Visa","truncatedNumber":"4024********4517","cardInternalId":"1"},{"internalId":"8","integrationId":null,"payday":"2020-06-15","installmentNumber":"2","tid":null,"additionalInfo":null,"customerInternalId":"1","customerIntegrationId":null,"link":"https://app.galaxpay.com.br/testegalaxpay/cobranca/2/cartao","paymentBillInternalId":"2","paymentBillIntegrationId":null,"paymentBillAdditionalInfo":null,"value":"50.00","authorizationCode":null,"lastUpdateDate":"","status":"notSend","statusDescription":"Ainda não enviada para operadora","isBoleto":false,"brand":"Visa","truncatedNumber":"4024********4517","cardInternalId":"1"}]}}

/getPaymentBillsByCustomer

Retorna todas as informações dos pagamentos e transações de um determinado cliente em um período de tempo específico.

Parâmetros

customerInternalId
string
255 caracteres
ID do cliente no cel_cash.
Exemplo: "1".
customerIntegrationId
string
255 caracteres
ID de integração informado ao cadastrar o cliente pelo parâmetro "integrationId".
ID do cliente no seu sistema.
Exemplo: "1".
customerDocument
string
255 caracteres
Documento, podendo ser CPF ou CNPJ, do cliente.
Exemplo: "012.345.678-90".
customerEmail
string
255 caracteres
E-mail de contato do cliente.
Exemplo: "[email protected]".
startDate
date
YYYY-mm-dd
Data inicial que deseja filtrar os resultados.
Exemplo: "2018-01-10".
endDate
date
YYYY-mm-dd
Data final que deseja filtrar os resultados.
Exemplo: "2018-12-15".
typeDate
string
Tipo de data a filtrar.
Exemplo: "dateOfLastUpdate".

Opções

Opções disponiveis para uso em "typeDate"
Valor Descrição
dateOfLastUpdate Data em que a transação foi capturada ou negada.
expirationDateOfTransaction Data de vencimento da transação.

NOTAS

58 - É obrigatório apenas um dos quatro parâmetros citados (customerInternalId, customerIntegrationId, customerDocument, customerEmail). Somente um destes parâmetros é considerado, logo, os mesmos estão em ordem de relevância.
59 - Caso sejam utilizados os filtros por data, todos estes parâmetros (typeDate, startDate, endDate) serão obrigatórios.
post
https://app.sandbox.cel.cash/webservice/getPaymentBillsByCustomer
{ "Auth": { "galaxId": "5473", "galaxHash": "83Mw5u8988Qj6fZqS4Z8K7LzOo1j28S706R0BeFe" } ,"Request": {"customerInternalId": "1"} }
{"type":true,"paymentBill":{"internalId":"1","integrationId":"","periodicity":"monthly","quantity":"6","status":"active","additionalInfo":null,"infoBoleto":"Referente ao pagamento da mensalidade","value":"50.00","customerInternalId":"1","customerIntegrationId":"","customerName":"cel_cash Teste","operator":"boletoGalaxPay","transactions":[{"internalId":"1","integrationId":null,"payday":"2020-05-15","installmentNumber":"1","additionalInfo":null,"customerInternalId":"1","customerIntegrationId":null,"paymentBillInternalId":"1","paymentBillIntegrationId":null,"paymentBillAdditionalInfo":null,"value":"50.00","lastUpdateDate":"2020-05-15 09:34:57","status":"pendingBoleto","statusDescription":"Em aberto","isBoleto":true,"boleto":"https://data.galaxpay.com.br/testegalaxpay/boleto/2020052PR6JHV2Z8EFQY1J7KLYCL0GF15093457","boletoBankLine":"03399022070600000001517232201016982560000005000","boletoBankNumber":"13485793TESTE-1172322249990985","qrCodePix":"ABC123ABC123ABC123ABC123ABC123ABC123ABC123ABC123ABC123ABC123ABC123","imageQrCodePix":"https://data.galaxpay.com.br/testegalaxpay/pix/13485793TESTE","pageQrCodePix":"https://gpay.com.br/q/5473/cce43a96"}]}}
{"type":true,"paymentBill":{"internalId":"2","integrationId":"","periodicity":"monthly","quantity":"5","status":"active","additionalInfo":null,"link":"https://app.galaxpay.com.br/testegalaxpay/cobranca/2/cartao","value":"50.00","brand":"Visa","cardTruncate":"4024********4517","customerInternalId":"1","customerIntegrationId":"","customerName":"cel_cash Teste","operator":"bin","transactions":[{"internalId":"7","integrationId":null,"payday":"2020-05-15","installmentNumber":"1","additionalInfo":null,"customerInternalId":"1","customerIntegrationId":null,"link":"https://app.galaxpay.com.br/testegalaxpay/cobranca/2/cartao","paymentBillInternalId":"2","paymentBillIntegrationId":null,"paymentBillAdditionalInfo":null,"value":"50.00","authorizationCode":"APROVADO89BIN90205","lastUpdateDate":"2020-05-15 09:48:43","status":"captured","statusDescription":"Capturada na Operadora","isBoleto":false,"brand":"Visa","truncatedNumber":"4024********4517","cardInternalId":"1"},{"internalId":"8","integrationId":null,"payday":"2020-06-15","installmentNumber":"2","additionalInfo":null,"customerInternalId":"1","customerIntegrationId":null,"link":"https://app.galaxpay.com.br/testegalaxpay/cobranca/2/cartao","paymentBillInternalId":"2","paymentBillIntegrationId":null,"paymentBillAdditionalInfo":null,"value":"50.00","authorizationCode":null,"lastUpdateDate":"","status":"notSend","statusDescription":"Ainda não enviada para operadora","isBoleto":false,"brand":"Visa","truncatedNumber":"4024********4517","cardInternalId":"1"}]}}

/getPaymentsWithCustomers

Retorna todas as informações do cliente, de seus pagamentos e transações em um período de tempo específico.

Parâmetros

startDate
date
YYYY-mm-dd
Obrigatorio
Data inicial que deseja filtrar os resultados.
Exemplo: "2018-01-10".
endDate
date
YYYY-mm-dd
Obrigatorio
Data final que deseja filtrar os resultados.
Exemplo: "2018-12-15".
typeDate
string
Obrigatorio
Tipo de data a filtrar.
Exemplo: "dateOfLastUpdate".

Opções

Opções disponiveis para uso em "typeDate"
Valor Descrição
dateOfLastUpdate Data em que a transação foi capturada ou negada.
expirationDateOfTransaction Data de vencimento da transação.
post
https://app.sandbox.cel.cash/webservice/getPaymentsWithCustomers
{ "Auth": { "galaxId": "5473", "galaxHash": "83Mw5u8988Qj6fZqS4Z8K7LzOo1j28S706R0BeFe" } ,"Request": {"startDate": "2018-01-10","endDate": "2018-12-15","typeDate": "dateOfLastUpdate"} }
{"type":true,"customers":[{"internalId":"3","integrationId":"14234","document":"06988994000182","name":"Cliente de Teste para Boleto","email":"[email protected]","phone":"(31) 9999-9999","cellphone":"null","isForeign":"false","insertdate":"2018-07-05 11:19:06","Address":{"street":"Rua Platina","number":"1330","complement":"null","neighborhood":"Calafatão","city":"Belo Horizonte","state":"MG","zipCode":"30411325","countryInitials":"null"},"paymentBill":{"internalId":"1","integrationId":"","periodicity":"monthly","quantity":"6","dateFirst":"2020-05-15","status":"active","statusDescription":"Ativa","additionalInfo":null,"urlCarne":"https://data.galaxpay.com.br/testegalaxpay/carne/c3b17e535f11c02338a0d05db4ac9b0a","infoBoleto":"Referente ao pagamento da mensalidade","value":"50.00","customerInternalId":"1","customerIntegrationId":"","customerName":"cel_cash Teste","operator":"boletoGalaxPay","operatorName":"Boleto cel_cash","transactions":[{"internalId":"1","integrationId":null,"payday":"2020-05-15","installmentNumber":"1","additionalInfo":null,"customerInternalId":"1","customerIntegrationId":null,"paymentBillInternalId":"1","paymentBillIntegrationId":null,"paymentBillAdditionalInfo":null,"value":"50.00","lastUpdateDate":"2020-05-15 09:34:57","status":"pendingBoleto","statusDescription":"Em aberto","isBoleto":true,"boleto":"https://data.galaxpay.com.br/testegalaxpay/boleto/2020052PR6JHV2Z8EFQY1J7KLYCL0GF15093457","boletoBankLine":"03399022070600000001517232201016982560000005000","boletoBankNumber":"13485793TESTE-1172322249990985","boletoEmissionDate":"2020-05-15 09:34:57","boletoBankEmissor":"santander","qrCodePix":"ABC123ABC123ABC123ABC123ABC123ABC123ABC123ABC123ABC123ABC123ABC123","imageQrCodePix":"https://data.galaxpay.com.br/testegalaxpay/pix/13485793TESTE","pageQrCodePix":"https://gpay.com.br/q/5473/cce43a96"}]}}]}
{"type":true,"customers":[{"internalId":"3","integrationId":"123","document":"12345678909","name":"Cliente de Teste para Cartão","email":"[email protected]","phone":"(31) 9999-9999","cellphone":"null","isForeign":"false","insertdate":"2018-07-05 11:19:06","Address":{"street":"Rua Platina","number":"1330","complement":"null","neighborhood":"Calafate","city":"Belo Horizonte","state":"MG","zipCode":"30411325","countryInitials":"null"},"paymentBill":{"internalId":"2","integrationId":"","periodicity":"monthly","quantity":"5","dateFirst":"2020-05-15","status":"active","statusDescription":"Ativa","additionalInfo":null,"link":"https://app.galaxpay.com.br/testegalaxpay/cobranca/2/cartao","value":"50.00","brand":"Visa","cardTruncate":"4024********4517","customerInternalId":"1","customerIntegrationId":"","customerName":"cel_cash Teste","operator":"bin","operatorName":"BIN","transactions":[{"internalId":"7","integrationId":null,"payday":"2020-05-15","installmentNumber":"1","tid":null,"additionalInfo":null,"customerInternalId":"1","customerIntegrationId":null,"link":"https://app.galaxpay.com.br/testegalaxpay/cobranca/2/cartao","paymentBillInternalId":"2","paymentBillIntegrationId":null,"paymentBillAdditionalInfo":null,"value":"50.00","authorizationCode":"APROVADO89BIN90205","lastUpdateDate":"2020-05-15 09:48:43","status":"captured","statusDescription":"Capturada na Operadora","isBoleto":false,"brand":"Visa","truncatedNumber":"4024********4517","cardInternalId":"1"},{"internalId":"8","integrationId":null,"payday":"2020-06-15","installmentNumber":"2","tid":null,"additionalInfo":null,"customerInternalId":"1","customerIntegrationId":null,"link":"https://app.galaxpay.com.br/testegalaxpay/cobranca/2/cartao","paymentBillInternalId":"2","paymentBillIntegrationId":null,"paymentBillAdditionalInfo":null,"value":"50.00","authorizationCode":null,"lastUpdateDate":"","status":"notSend","statusDescription":"Ainda não enviada para operadora","isBoleto":false,"brand":"Visa","truncatedNumber":"4024********4517","cardInternalId":"1"}]}}]}

/cancelPaymentBill

Área destinada para cancelar um Contrato/Venda específica. Ao cancelar não será realizado nenhum tipo de cobrança para o cliente.

Parâmetros

paymentBillInternalId
integer
11 caracteres
ID do Contrato/Venda no cel_cash.
Exemplo: "1".
paymentBillIntegrationId
string
255 caracteres
ID de integração informado ao cadastrar o Contrato/Venda pelo parâmetro "integrationId".
ID do contrato/venda no seu sistema.
Exemplo: "1".

NOTAS

60 - É obrigatório o uso de apenas um dos parâmetros citados acima.
61 - Somente um destes parâmetros será considerado e por isso, estão citados acima por ordem de relevância.
post
https://app.sandbox.cel.cash/webservice/cancelPaymentBill
{ "Auth": { "galaxId": "5473", "galaxHash": "83Mw5u8988Qj6fZqS4Z8K7LzOo1j28S706R0BeFe" } ,"Request": {"paymentBillIntegrationId": "1"} }
{"type": "true","message": "Transação cancelada com sucesso."}

/updatePaymentBillCard

Área destinada para atualizar o cartão de um Contrato/Venda para futuras cobranças ou novas tentativas em transações negadas.

Parâmetros

paymentBillInternalId
integer
11 caracteres
ID do Contrato/Venda no cel_cash.
Exemplo: "1".
paymentBillIntegrationId
string
255 caracteres
ID de integração informado ao cadastrar o Contrato/Venda pelo parâmetro "integrationId".
ID do contrato/venda no seu sistema.
Exemplo: "1".
customerInternalId
integer
11 caracteres
ID do cliente no cel_cash.
Exemplo: "1".
customerIntegrationId
string
255 caracteres
ID de integração informado ao cadastrar o cliente pelo parâmetro "integrationId".
ID do cliente no seu sistema.
Exemplo: "1".
Card
Dados do cartão do cliente.
integrationId
string
255 caracteres
ID de integração informado ao cadastrar um cartão.
ID do cartão no seu sistema.
Exemplo: "1".
number
string
255 caracteres
Número do cartão.
Exemplo: "4716 0248 9944 1650".
holder
string
30 caracteres
Nome do portador do cartão (Nome no cartão).
Exemplo: "Cliente de exemplo cel_cash".
expiryMonth
integer
2 caracteres
Mês de expiração do cartão.
Exemplo: "04".
expiryYear
integer
4 caracteres
Ano de expiração do cartão.
Exemplo: "2023".
cvv
integer
4 caracteres
Código de segurança do cartão.
Exemplo: "541".
brand
string
36 caracteres
Bandeira do cartão
Exemplo: "visa".

NOTAS

62 - Um dos parâmetros, "paymentBillIntegrationId" ou "paymentBillInternalId", é necessário ser informado.
63 - Um dos parâmetros, "customerIntegrationId" ou "customerInternalId", é necessário ser informado.
64 - A bandeira do cartão para utilizar no parâmetro "brand" pode ser obtida utilizando o resultado do método "/getCardBrandsByOperator".
post
https://app.sandbox.cel.cash/webservice/updatePaymentBillCard
{ "Auth": { "galaxId": "5473", "galaxHash": "83Mw5u8988Qj6fZqS4Z8K7LzOo1j28S706R0BeFe" } ,"Request": {"paymentBillIntegrationId": "1","customerIntegrationId": "1","Card": {"integrationId": "1","number": "4716 0248 9944 1650","holder": "Cliente de exemplo cel_cash","expiryMonth": "04","expiryYear": "2023","cvv": "541","brand": "visa"}} }
{"type": "true","message": "Cartão atualizado com sucesso."}

/getCarneList

Método utilizado para a geração de carnês em massa, ao termino da geração de cada carnê o sistema irá enviar um Webhook informando os dados sobre o carnê.

Parâmetros

billInternalIds
string
IDs dos Contratos/Vendas no cel_cash
Exemplo: "11,52,63".
billIntegrationIds
string
IDs de integração dos Contratos/Vendas no cel_cash
Exemplo: "120C,541T,636R".

NOTAS

65 - É obrigatório apenas um dos dois parâmetros citados (billInternalIds, billIntegrationIds).
Somente um destes parâmetros é considerado, logo, os mesmos estão em ordem de relevância.
66 - Separe o IDs por vírgula, conforme o exemplo.
67 - O evento "bill.generatePaper", informado nos eventos de Webhook, é responsavel em informar o termino da geração do carnê.
post
https://app.sandbox.cel.cash/webservice/getCarneList
{ "Auth": { "galaxId": "5473", "galaxHash": "83Mw5u8988Qj6fZqS4Z8K7LzOo1j28S706R0BeFe" } ,"Request": {"billInternalIds": "11,52,63"} }
{"type":"true","message":"A fila para geração de carnês começou a ser processada."}

/getCarneCustom

Método utilizado para a geração de um carnê com diferentes Contratos/Vendas ou Transações, ao término da geração do carnê o sistema irá enviar um Webhook informando os dados sobre o carnê.

Parâmetros

billInternalIds
string
IDs dos Contratos/Vendas no cel_cash
Exemplo: "11,52,63".
billIntegrationIds
string
IDs de integração dos Contratos/Vendas no cel_cash
Exemplo: "120C,541T,636R".
transactionInternalIds
string
IDs das transações no cel_cash.
Exemplo: "1".
transactionIntegrationIds
string
IDs das transações que são utilizadas para relacionar seu sistema com o cel_cash.
IDs das transações no seu sistema.
Exemplo: "1A".

NOTAS

68 - O carnê personalizado somente irá ser gerado se todas as transações estiverem válidas para serem acrescentadas no carnê.
69 - É obrigatório apenas um dos quatro parâmetros citados (billInternalIds, billIntegrationIds, transactionInternalIds, transactionIntegrationIds).
Somente um destes parâmetros é considerado, logo, os mesmos estão em ordem de relevância.
70 - Separe o IDs por vírgula, conforme o exemplo.
71 - O evento "bill.generatePaperCustom", informado nos eventos de Webhook, é responsavel em informar o termino da geração do carnê.
post
https://app.sandbox.cel.cash/webservice/getCarneCustom
{ "Auth": { "galaxId": "5473", "galaxHash": "83Mw5u8988Qj6fZqS4Z8K7LzOo1j28S706R0BeFe" } ,"Request": {"billInternalIds": "11,52,63"} }
{"type":"true","message":"A geração do carnê foi iniciada. Assim que finalizado, você irá receber o webhook."}

/updateIndeterminatedContractValue

Área destinada para alteração de valor de um Contrato indeterminado. Este método não irá alterar o valor das transações já geradas.

Parâmetros

paymentBillInternalId
integer
11 caracteres
ID do Contrato/Venda no cel_cash.
Exemplo: "1".
paymentBillIntegrationId
string
255 caracteres
ID de integração informado ao cadastrar o Contrato/Venda pelo parâmetro "integrationId".
ID do contrato/venda no seu sistema.
Exemplo: "1".
value
decimal
Obrigatorio
Valor das próximas transações
Exemplo: "80.00".

NOTAS

72 - Um dos parâmetros, "paymentBillIntegrationId" ou "paymentBillInternalId", é necessário ser informado.
post
https://app.sandbox.cel.cash/webservice/updateIndeterminatedContractValue
{ "Auth": { "galaxId": "5473", "galaxHash": "83Mw5u8988Qj6fZqS4Z8K7LzOo1j28S706R0BeFe" } ,"Request": {"paymentBillIntegrationId": "1","value": "80.00"} }
{"type": "true","message": "Valor alterado com sucesso."}

/changeNfseEmission

Área destinada para alterar informações de emissão de nota fiscal de um contrato. Caso atualizado o momento de emissão das notas fiscais, as notas com vencimento anterior a data de atualização, não serão emitidas de acordo com a nova regra.

Parâmetros

paymentBillInternalId
integer
11 caracteres
ID do Contrato/Venda no cel_cash.
Exemplo: "1".
paymentBillIntegrationId
string
255 caracteres
ID de integração informado ao cadastrar o Contrato/Venda pelo parâmetro "integrationId".
ID do contrato/venda no seu sistema.
Exemplo: "1".
isToGenerate
bool
Obrigatorio
Utilizado para informar se irá ou não gerar nota fiscal
Exemplo: "true".
type
string
255 caracteres
Utilizado para informar como as notas fiscais irão ser geradas.
Exemplo: "uniqueNf".

Opções

Opções disponiveis para uso em "type"
Valor Descrição
uniqueNf Gerar uma única nota fiscal para a venda.
transactionsNf Gerar uma nota fiscal para cada parcela (transação).
moment
string
255 caracteres
Momento da emissão de nota fiscal.
Exemplo: "afterpay".

Opções

Opções disponiveis para uso em "moment"
Valor Descrição
create Ao cadastrar transação (transações parceladas somente após o pagamento)
notification No momento do envio do boleto (envio da notificação)
before Dias antes do vencimento da transação
afterpay Após transação ser paga
daysBeforePayday
bool
Dias antes para Emissão.
Somente para o momento de emissão da nota "Dias antes do vencimento da transação".
Exemplo: "3".

NOTAS

73 - Um dos parâmetros, "paymentBillIntegrationId" ou "paymentBillInternalId", é necessário ser informado.
post
https://app.sandbox.cel.cash/webservice/changeNfseEmission
{ "Auth": { "galaxId": "5473", "galaxHash": "83Mw5u8988Qj6fZqS4Z8K7LzOo1j28S706R0BeFe" } ,"Request": {"paymentBillIntegrationId": "1","isToGenerate": "true","moment": "afterpay"} }
{"type": "true","message": "Informações alteradas com sucesso."}

Transações

Área destinada as transações de Contratos/Vendas, você conseguirá retornar todas transações necessárias em uma lista, estornar uma transação, cancelar uma transação, visualize uma lista contendo todos os status de transações disponíveis para seu sistema, dentre outras funcionalidades.Etapa 3

/addTransactionContract

Acrescenta uma transação em um Contrato já existente.

Parâmetros

paymentBillInternalId
integer
11 caracteres
ID do Contrato/Venda no cel_cash.
Exemplo: "1".
paymentBillIntegrationId
string
255 caracteres
ID de integração informado ao cadastrar o Contrato/Venda pelo parâmetro "integrationId".
ID do contrato/venda no seu sistema.
Exemplo: "1".
payday
date
YYYY-mm-dd
Obrigatorio
Data de vencimento da transação.
Exemplo: "2019-02-07".
paymentType
string
255 caracteres
Utilizado para cadastrar a transação como paga. Único valor disponível é "payed"
Exemplo: "payed".

Opções

Opções disponiveis para uso em "paymentType"
Valor Descrição
payed Para cadastrar a transação já com o status "Paga fora do sistema".
payDate
date
YYYY-mm-dd
Utilizado apenas quando o "paymentType" for "payed". Use esse campo para informar a data do pagamento. Caso não informado, irá utilizar a data de cadastro da transação.
Exemplo: "2018-06-21".
value
decimal
Obrigatorio
Valor da transação
Exemplo: "80.00".
integrationId
integer
11 caracteres
ID da transação que é utilizado para relacionar seu sistema com o cel_cash.
ID da transação no seu sistema.
Exemplo: "1".
additionalInfo
string
Observações sobre a transação, apenas para controle interno no sistema.
Exemplo: "Transação referente ao mês de janeiro.".
Invoice
Informações necessárias a serem informadas para a geração de nota fiscal. Caso nada seja preenchido, irá respeitar o que está configurado no contrato.
isToGenerate
string
Obrigatorio
Utilizado para informar se é para gerar nota fiscal. A configuração feita aqui sobrepõe o que está configurado no contrato, a menos que seja "none".
Exemplo: "true".

Opções

Opções disponiveis para uso em "isToGenerate"
Valor Descrição
true Gera nota fiscal para essa transação.
false Não gera nota fiscal para a transação.
none Respeita o que está configurado no contrato.
moment
string
255 caracteres
Momento da emissão de nota fiscal. Obrigatório apenas se o parâmetro "isToGenerate" for preenchido com "true".
Exemplo: "afterpay".

Opções

Opções disponiveis para uso em "moment"
Valor Descrição
create Ao cadastrar transação
notification No momento do envio do boleto (envio da notificação)
before Dias antes do vencimento da transação
afterpay Após transação ser paga
daysBeforePayday
integer
11 caracteres
Dias antes para Emissão. Obrigatório apenas se o parâmetro "moment" for preenchido com "before".
Exemplo: "3".
subAccountBilling
integer
11 caracteres
ID da subconta para emissão da nota fiscal. Caso não informado, será emitido para a conta principal.
Exemplo: "1532".
description
string
255 caracteres
Descrição da transação para a geração de nota fiscal.
Caso não seja informado, iremos aplicar o que está salvo no contrato.
Exemplo: "NF primeira mensalidade".
Antifraud
Dados de analise do antifraude.
sessionId
string
255 caracteres
Obrigatorio
Código único do usuário logado no sistema do seu e-commerce.
Exemplo: "65a7e35f4a6s7dfa46a78sd".
ipCustomer
string
255 caracteres
Obrigatorio
IP do computador do cliente que esta realizando a compra.
Exemplo: "195.113.54.21".

NOTAS

74 - Um dos parâmetros, "paymentBillInternalId" ou "paymentBillIntegrationId", é necessario ser informado, logo, os mesmos estão em ordem de relevância.
75 - Caso o Contrato/Venda esteja encerrado, irá ser ativado novamente.
post
https://app.sandbox.cel.cash/webservice/addTransactionContract
{ "Auth": { "galaxId": "5473", "galaxHash": "83Mw5u8988Qj6fZqS4Z8K7LzOo1j28S706R0BeFe" } ,"Request": {"paymentBillIntegrationId": "1","payday": "2019-02-07","value": "80.00","Invoice": {"isToGenerate": "true","moment": "afterpay","subAccountBilling": "1532","description": "NF primeira mensalidade"}} }
{"type":"true","transaction":{"internalId":"1","value":"100","payday":"2018-08-07","lastUpdateDate":"2018-08-07 17:45:18","authorizationCode":"","status":"denied","statusDescription":"Negada na Operadora"}}

/getTransaction

Retorna informações sobre uma determinada transação.

Parâmetros

transactionInternalId
integer
11 caracteres
ID da transação dentro do sistema
Exemplo: "1".
transactionIntegrationId
integer
11 caracteres
ID da transação que é utilizado para relacionar seu sistema com o cel_cash.
ID da transação no seu sistema.
Exemplo: "1".
transactionTid
integer
11 caracteres
TID da transação
Exemplo: "1AABBCC4CC".

NOTAS

76 - É obrigatório o uso de apenas um dos parâmetros citados acima, logo, os mesmos estão em ordem de relevância.
post
https://app.sandbox.cel.cash/webservice/getTransaction
{ "Auth": { "galaxId": "5473", "galaxHash": "83Mw5u8988Qj6fZqS4Z8K7LzOo1j28S706R0BeFe" } ,"Request": {"transactionInternalId": "1"} }
{"type":true,"transaction":{"internalId":"89532","integrationId":null,"payday":"2020-05-20","installmentNumber":"1","tid":null,"additionalInfo":null,"customerInternalId":"3386","customerIntegrationId":"15523","link":"https://app.galaxpay.com.br/testegalaxpay/cobranca/14873/cartao","paymentBillInternalId":"14873","paymentBillIntegrationId":null,"paymentBillAdditionalInfo":null,"value":"50.00","lastUpdateDate":"2020-05-20 09:58:35","status":"pendingBoleto","statusDescription":"Em aberto","isBoleto":true,"boleto":"https://data.galaxpay.com.br/testegalaxpay/boleto/202005NDXD41J99J4W0FDRZ13DB018720095835","boletoBankLine":"03399022070600000001518988501013682610000005000","boletoBankNumber":"701915336TESTE-1189885786007956","boletoEmissionDate":"2020-05-20 09:58:35","boletoBankEmissor":"santander","qrCodePix":"ABC123ABC123ABC123ABC123ABC123ABC123ABC123ABC123ABC123ABC123ABC123","imageQrCodePix":"https://data.galaxpay.com.br/testegalaxpay/pix/13485793TESTE","pageQrCodePix":"https://gpay.com.br/q/5473/cce43a96","invoiceDescription":"Teste cel_cash","invoiceStatus":"emmited","invoiceStatusDescription":"NFS-e emitida","invoicePdf":"https://data.galaxpay.com.br/testegalaxpay/download-invoice-pdf/d8ebda6e3f269f772af4dd9f949a5243","invoiceXml":"https://data.galaxpay.com.br/testegalaxpay/download-invoice-xml/d8ebda6e3f269f772af4dd9f949a5243"}}
{"type":true,"transaction":{"internalId":"89531","integrationId":null,"payday":"2020-05-20","installmentNumber":"1","tid":null,"additionalInfo":null,"customerInternalId":"3386","customerIntegrationId":"15523","link":"https://app.galaxpay.com.br/testegalaxpay/cobranca/14872/cartao","paymentBillInternalId":"14872","paymentBillIntegrationId":null,"paymentBillAdditionalInfo":null,"value":"50.00","authorizationCode":"APROVADO37BIN96787","lastUpdateDate":"2020-05-20 09:55:51","status":"captured","statusDescription":"Capturada na Operadora","isBoleto":true,"boleto":"https://data.galaxpay.com.br/testegalaxpay/boleto/202005IHBHVPDJS38LDLNOJ4JGQV3CH20095550","boletoBankLine":null,"boletoBankNumber":null,"boletoEmissionDate":null,"boletoBankEmissor":null,"brand":"Visa","truncatedNumber":"4024********4517","cardInternalId":"10100","invoiceDescription":"teste","invoiceStatus":"emmited","invoiceStatusDescription":"NFS-e emitida","invoicePdf":"https://data.galaxpay.com.br/testegalaxpay/download-invoice-pdf/fe6e8dc5301977d91e9e735f8761e669","invoiceXml":"https://data.galaxpay.com.br/testegalaxpay/download-invoice-xml/fe6e8dc5301977d91e9e735f8761e669","operator":"bin"}}

/getTransactionsByPaymentBill

Retorna uma lista com todas as transações de um Contrato/Venda com informações necessárias, como o status e valor.

Parâmetros

internalId
integer
11 caracteres
ID do Contrato/Venda no cel_cash.
Exemplo: "1".
integrationId
string
255 caracteres
ID do Contrato/Venda que é utilizado para relacionar seu sistema com o cel_cash.
ID do Contrato/Venda no seu sistema.
Exemplo: "1".
startDate
date
YYYY-mm-dd
Data de vencimento (payDay) inicial que deseja filtrar os resultados.
Exemplo: "2018-01-10".
endDate
date
YYYY-mm-dd
Data de vencimento (payDay) final que deseja filtrar os resultados.
Exemplo: "2018-12-15".

NOTAS

77 - É obrigatório o uso de apenas um dos parâmetros citados acima, logo, os mesmos estão em ordem de relevância.
78 - Caso a transação seja do tipo de boleto o RESPONSE do método retornará a URL do boleto e a linha digitável.
post
https://app.sandbox.cel.cash/webservice/getTransactionsByPaymentBill
{ "Auth": { "galaxId": "5473", "galaxHash": "83Mw5u8988Qj6fZqS4Z8K7LzOo1j28S706R0BeFe" } ,"Request": {"integrationId": "1"} }
{"type":true,"paymentBillInternalId":"14875","paymentBillIntegrationId":null,"transactions":[{"internalId":"89536","integrationId":null,"payday":"2020-05-20","installmentNumber":"1","tid":null,"additionalInfo":null,"customerInternalId":"3386","customerIntegrationId":"15523","link":"https://app.galaxpay.com.br/developers/online/testegalaxpay/cobranca/14875","paymentBillInternalId":"14875","paymentBillIntegrationId":null,"paymentBillAdditionalInfo":null,"value":"50.00","lastUpdateDate":"2020-05-20 10:06:16","status":"payedBoleto","statusDescription":"Boleto compensado","isBoleto":true,"boleto":"https://data.galaxpay.com.br/testegalaxpay/boleto/2020055WBKJBILQJMPDRK0OC110I0AT20100553","boletoBankLine":"03399022070600000001518990601017482610000005000","boletoBankNumber":"329105619TESTE-1189906289476013","boletoEmissionDate":"2020-05-20 10:05:53","boletoBankEmissor":"santander","qrCodePix":"ABC123ABC123ABC123ABC123ABC123ABC123ABC123ABC123ABC123ABC123ABC123","imageQrCodePix":"https://data.galaxpay.com.br/testegalaxpay/pix/13485793TESTE","pageQrCodePix":"https://gpay.com.br/q/5473/cce43a96","invoiceDescription":"Teste cel_cash","invoiceStatus":"emmited","invoiceStatusDescription":"NFS-e emitida","invoicePdf":"https://data.galaxpay.com.br/testegalaxpay/download-invoice-pdf/775ff89c24b044629e4f9bb580e81cc2","invoiceXml":"https://data.galaxpay.com.br/testegalaxpay/download-invoice-xml/775ff89c24b044629e4f9bb580e81cc2"},{"internalId":"89537","integrationId":null,"payday":"2020-06-20","installmentNumber":"2","tid":null,"additionalInfo":null,"customerInternalId":"3386","customerIntegrationId":"15523","link":"https://app.galaxpay.com.br/developers/online/testegalaxpay/cobranca/14875","paymentBillInternalId":"14875","paymentBillIntegrationId":null,"paymentBillAdditionalInfo":null,"value":"50.00","lastUpdateDate":"2020-05-20 10:05:56","status":"pendingBoleto","statusDescription":"Em aberto","isBoleto":true,"boleto":"https://data.galaxpay.com.br/testegalaxpay/boleto/202005OSGD4PB6BWN08418KKOV9AMQA20100556","boletoBankLine":null,"boletoBankNumber":null,"boletoEmissionDate":null,"boletoBankEmissor":null,"qrCodePix":null,"imageQrCodePix":null,"pageQrCodePix":null,"invoiceDescription":"Teste cel_cash","invoiceStatus":"emmited","invoiceStatusDescription":"NFS-e emitida","invoicePdf":"https://data.galaxpay.com.br/testegalaxpay/download-invoice-pdf/6daf35f34441de05ed50deeb7053f053","invoiceXml":"https://data.galaxpay.com.br/testegalaxpay/download-invoice-xml/6daf35f34441de05ed50deeb7053f053"}]}
{"type":true,"paymentBillInternalId":"14874","paymentBillIntegrationId":null,"transctions":[{"internalId":"89533","integrationId":null,"payday":"2020-05-20","installmentNumber":"1","tid":null,"additionalInfo":null,"customerInternalId":"3386","customerIntegrationId":"15523","link":"https://app.galaxpay.com.br/testegalaxpay/cobranca/14874/cartao","paymentBillInternalId":"14874","paymentBillIntegrationId":null,"paymentBillAdditionalInfo":null,"value":"50.00","authorizationCode":"APROVADO18BIN31122","lastUpdateDate":"2020-05-20 10:02:03","status":"captured","statusDescription":"Capturada na Operadora","isBoleto":true,"boleto":"https://data.galaxpay.com.br/testegalaxpay/boleto/2020051L22IDH203CATS8Q0YY2ZY9MT20100202","boletoBankLine":null,"boletoBankNumber":null,"boletoEmissionDate":null,"boletoBankEmissor":null,"brand":"Visa","truncatedNumber":"4024********4517","cardInternalId":"10100","invoiceDescription":"Nota fiscal parcela 1","invoiceStatus":"emmited","invoiceStatusDescription":"NFS-e emitida","invoicePdf":"https://data.galaxpay.com.br/testegalaxpay/download-invoice-pdf/be6ac147e7801ed99bbfc9703a992161","invoiceXml":"https://data.galaxpay.com.br/testegalaxpay/download-invoice-xml/be6ac147e7801ed99bbfc9703a992161","operator":"bin"},{"internalId":"89534","integrationId":null,"payday":"2020-06-20","installmentNumber":"2","tid":null,"additionalInfo":null,"customerInternalId":"3386","customerIntegrationId":"15523","link":"https://app.galaxpay.com.br/testegalaxpay/cobranca/14874/cartao","paymentBillInternalId":"14874","paymentBillIntegrationId":null,"paymentBillAdditionalInfo":null,"value":"50.00","authorizationCode":null,"lastUpdateDate":"","status":"notSend","statusDescription":"Ainda não enviada para operadora","isBoleto":true,"boleto":"https://data.galaxpay.com.br/testegalaxpay/boleto/202005EHHAHFVQC2J9P258C9MFFT13V20100203","boletoBankLine":null,"boletoBankNumber":null,"boletoEmissionDate":null,"boletoBankEmissor":null,"brand":"Visa","truncatedNumber":"4024********4517","cardInternalId":"10100","operator":"bin" },{"internalId":"89535","integrationId":null,"payday":"2020-07-20","installmentNumber":"3","tid":null,"additionalInfo":null,"customerInternalId":"3386","customerIntegrationId":"15523","link":"https://app.galaxpay.com.br/testegalaxpay/cobranca/14874/cartao","paymentBillInternalId":"14874","paymentBillIntegrationId":null,"paymentBillAdditionalInfo":null,"value":"50.00","authorizationCode":null,"lastUpdateDate":"","status":"notSend","statusDescription":"Ainda não enviada para operadora","isBoleto":true,"boleto":"https://data.galaxpay.com.br/testegalaxpay/boleto/202005KYV1QIEU1KNXI9U4DHBJG8VXS20100203","boletoBankLine":null,"boletoBankNumber":null,"boletoEmissionDate":null,"boletoBankEmissor":null,"brand":"Visa","truncatedNumber":"4024********4517","cardInternalId":"10100","operator":"bin"}]}

/getTransactions

Retorna uma lista contendo transações de diferentes Contratos/Vendas filtradas por uma data específica.

Parâmetros

startDate
date
YYYY-mm-dd
Obrigatorio
Data inicial que deseja filtrar os resultados.
Exemplo: "2018-01-10".
endDate
date
YYYY-mm-dd
Obrigatorio
Data final que deseja filtrar os resultados.
Exemplo: "2018-12-15".
typeDate
string
Obrigatorio
Tipo de data a filtrar.
Exemplo: "dateOfLastUpdate".

Opções

Opções disponiveis para uso em "typeDate"
Valor Descrição
dateOfLastUpdate Data em que a transação foi capturada ou negada.
expirationDateOfTransaction Data de vencimento da transação.
conciliationDate Data em que foi feita a conciliação bancária.
transactionStatus
array
Array com status que deseja filtrar. Caso não informado, retornará qualquer status. A lista de status válidos é retornada pelo método "getAllStatusTransaction"
Exemplo: "["payedBoleto", "captured"]".
post
https://app.sandbox.cel.cash/webservice/getTransactions
{ "Auth": { "galaxId": "5473", "galaxHash": "83Mw5u8988Qj6fZqS4Z8K7LzOo1j28S706R0BeFe" } ,"Request": {"startDate": "2018-01-10","endDate": "2018-12-15","typeDate": "dateOfLastUpdate"} }
{"type":true,"paymentBills":[{"internalId":"14875","integrationId":"","periodicity":"monthly","quantity":"2","dateFirst":"2020-05-20","status":"active","statusDescription":"Ativa","additionalInfo":null,"link":"https://app.galaxpay.com.br/testegalaxpay/cobranca/14875/cartao","urlCarne":"https://data.galaxpay.com.br/testegalaxpay/carne/1277a2e5a05a8471a47a7fd88960ec04","infoBoleto":"Teste cel_cash","value":"50.00","customerInternalId":"3386","customerIntegrationId":"15523","customerName":"Teste Cliente cel_cash","operator":"boletoGalaxPay","operatorName":"Boleto cel_cash","transactions":[{"internalId":"89536","integrationId":null,"payday":"2020-05-20","installmentNumber":"1","tid":null,"additionalInfo":null,"customerInternalId":"3386","customerIntegrationId":"15523","link":"https://app.galaxpay.com.br/testegalaxpay/cobranca/14875/cartao","paymentBillInternalId":"14875","paymentBillIntegrationId":null,"paymentBillAdditionalInfo":null,"value":"50.00","lastUpdateDate":"2020-05-20 10:06:16","status":"payedBoleto","statusDescription":"Boleto compensado","isBoleto":true,"boleto":"https://data.galaxpay.com.br/testegalaxpay/boleto/2020055WBKJBILQJMPDRK0OC110I0AT20100553","boletoBankLine":"03399022070600000001518990601017482610000005000","boletoBankNumber":"329105619TESTE-1189906289476013","boletoEmissionDate":"2020-05-20 10:05:53","boletoBankEmissor":"santander","qrCodePix":"ABC123ABC123ABC123ABC123ABC123ABC123ABC123ABC123ABC123ABC123ABC123","imageQrCodePix":"https://data.galaxpay.com.br/testegalaxpay/pix/13485793TESTE","pageQrCodePix":"https://gpay.com.br/q/5473/cce43a96","invoiceDescription":"Teste cel_cash","invoiceStatus":"emmited","invoiceStatusDescription":"NFS-e emitida","invoicePdf":"https://data.galaxpay.com.br/testegalaxpay/download-invoice-pdf/775ff89c24b044629e4f9bb580e81cc2","invoiceXml":"https://data.galaxpay.com.br/testegalaxpay/download-invoice-xml/775ff89c24b044629e4f9bb580e81cc2"}]}]}
{"type":true,"paymentBills":[{"internalId":"14874","integrationId":"","periodicity":"monthly","quantity":"3","dateFirst":"2020-05-20","status":"active","statusDescription":"Ativa","additionalInfo":null,"link":"https://app.galaxpay.com.br/testegalaxpay/cobranca/14874/cartao","value":"50.00","brand":"Visa","cardTruncate":"4024********4517","customerInternalId":"3386","customerIntegrationId":"15523","customerName":"Teste Cliente cel_cash","operator":"bin","operatorName":"BIN","transactions":[{"internalId":"89533","integrationId":null,"payday":"2020-05-20","installmentNumber":"1","tid":null,"additionalInfo":null,"customerInternalId":"3386","customerIntegrationId":"15523","link":"https://app.galaxpay.com.br/testegalaxpay/cobranca/14874/cartao","paymentBillInternalId":"14874","paymentBillIntegrationId":null,"paymentBillAdditionalInfo":null,"value":"50.00","authorizationCode":"APROVADO18BIN31122","lastUpdateDate":"2020-05-20 10:02:03","status":"captured","statusDescription":"Capturada na Operadora","isBoleto":true,"boleto":"https://data.galaxpay.com.br/testegalaxpay/boleto/2020051L22IDH203CATS8Q0YY2ZY9MT20100202","boletoBankLine":null,"boletoBankNumber":null,"boletoEmissionDate":null,"boletoBankEmissor":null,"brand":"Visa","truncatedNumber":"4024********4517","cardInternalId":"10100","invoiceDescription":"Nota fiscal parcela 1","invoiceStatus":"emmited","invoiceStatusDescription":"NFS-e emitida","invoicePdf":"https://data.galaxpay.com.br/testegalaxpay/download-invoice-pdf/be6ac147e7801ed99bbfc9703a992161","invoiceXml":"https://data.galaxpay.com.br/testegalaxpay/download-invoice-xml/be6ac147e7801ed99bbfc9703a992161","operator":"bin"}]}]}

/getTransactionsByIds

Retorna uma lista contendo transações de diferentes Contratos/Vendas filtradas.

Parâmetros

ids
string
IDs das transações no cel_cash
Exemplo: "73991, 74002".
integrationIds
string
IDs de integração das transações no cel_cash
Exemplo: "120C,541T,636R".

NOTAS

79 - É obrigatório o uso de apenas um dos parâmetros citados acima, logo, os mesmos estão em ordem de relevância.
post
https://app.sandbox.cel.cash/webservice/getTransactionsByIds
{ "Auth": { "galaxId": "5473", "galaxHash": "83Mw5u8988Qj6fZqS4Z8K7LzOo1j28S706R0BeFe" } ,"Request": {"ids": "73991, 74002"} }
{"type":true,"transactions":[{"internalId":"89536","integrationId":null,"payday":"2020-05-20","installmentNumber":"1","tid":null,"additionalInfo":null,"customerInternalId":"3386","customerIntegrationId":"15523","link":"https://app.galaxpay.com.br/testegalaxpay/cobranca/14875/cartao","paymentBillInternalId":"14875","paymentBillIntegrationId":null,"paymentBillAdditionalInfo":null,"value":"50.00","lastUpdateDate":"2020-05-20 10:06:16","status":"payedBoleto","statusDescription":"Boleto compensado","isBoleto":true,"boleto":"https://data.galaxpay.com.br/testegalaxpay/boleto/2020055WBKJBILQJMPDRK0OC110I0AT20100553","boletoBankLine":"03399022070600000001518990601017482610000005000","boletoBankNumber":"329105619TESTE-1189906289476013","boletoEmissionDate":"2020-05-20 10:05:53","boletoBankEmissor":"santander","qrCodePix":"ABC123ABC123ABC123ABC123ABC123ABC123ABC123ABC123ABC123ABC123ABC123","imageQrCodePix":"https://data.galaxpay.com.br/testegalaxpay/pix/13485793TESTE","pageQrCodePix":"https://gpay.com.br/q/5473/cce43a96","invoiceDescription":"Teste cel_cash","invoiceStatus":"emmited","invoiceStatusDescription":"NFS-e emitida","invoicePdf":"https://data.galaxpay.com.br/testegalaxpay/download-invoice-pdf/775ff89c24b044629e4f9bb580e81cc2","invoiceXml":"https://data.galaxpay.com.br/testegalaxpay/download-invoice-xml/775ff89c24b044629e4f9bb580e81cc2"}]}
{"type":true,"transactions":[{"internalId":"89533","integrationId":null,"payday":"2020-05-20","installmentNumber":"1","tid":null,"additionalInfo":null,"customerInternalId":"3386","customerIntegrationId":"15523","link":"https://app.galaxpay.com.br/testegalaxpay/cobranca/14874/cartao","paymentBillInternalId":"14874","paymentBillIntegrationId":null,"paymentBillAdditionalInfo":null,"value":"50.00","authorizationCode":"APROVADO18BIN31122","lastUpdateDate":"2020-05-20 10:02:03","status":"captured","statusDescription":"Capturada na Operadora","isBoleto":true,"boleto":"https://data.galaxpay.com.br/testegalaxpay/boleto/2020051L22IDH203CATS8Q0YY2ZY9MT20100202","boletoBankLine":null,"boletoBankNumber":null,"boletoEmissionDate":null,"boletoBankEmissor":null,"brand":"Visa","truncatedNumber":"4024********4517","cardInternalId":"10100","invoiceDescription":"Nota fiscal parcela 1","invoiceStatus":"emmited","invoiceStatusDescription":"NFS-e emitida","invoicePdf":"https://data.galaxpay.com.br/testegalaxpay/download-invoice-pdf/be6ac147e7801ed99bbfc9703a992161","invoiceXml":"https://data.galaxpay.com.br/testegalaxpay/download-invoice-xml/be6ac147e7801ed99bbfc9703a992161","operator":"bin"}]}

/updateTransactionCard

Área destinada para atualizar o cartão de uma transação.

Parâmetros

transactionInternalId
integer
11 caracteres
ID da transação dentro do sistema
Exemplo: "1".
transactionIntegrationId
integer
11 caracteres
ID da transação que é utilizado para relacionar seu sistema com o cel_cash.
ID da transação no seu sistema.
Exemplo: "1".
cardInternalId
integer
11 caracteres
ID do cartão no cel_cash.
Exemplo: "1".
cardIntegrationId
string
255 caracteres
ID do cartão que é utilizado para relacionar seu sistema com o cel_cash.
ID do cartão no seu sistema.
Exemplo: "1".
cardBill
bool
Parâmetro que define que deseja utilizar o cartão da cobrança.
Exemplo: "true".

NOTAS

80 - Um dos parâmetros, "transactionInternalId" ou "transactionIntegrationId", é necessario ser informado, logo, os mesmos estão em ordem de relevância.
81 - Um dos parâmetros, "cardInternalId", "cardIntegrationId" ou "cardBill", é necessario ser informado, logo, os mesmos estão em ordem de relevância.
post
https://app.sandbox.cel.cash/webservice/updateTransactionCard
{ "Auth": { "galaxId": "5473", "galaxHash": "83Mw5u8988Qj6fZqS4Z8K7LzOo1j28S706R0BeFe" } ,"Request": {"transactionInternalId": "1","cardInternalId": "1"} }
{"type": "true","paymentBillInternalId": "123","transactions": [{"internalId": "123","value": "89.99","payday": "2018-06-21","lastUpdateDate": "2018-06-21 00:00:00","authorizationCode": "123","status": "captured","statusDescription": "Capturada na Operadora"}]}

/updateTransactionInfo

Área destinada para alteração de informações da transação.

Parâmetros

paymentBillInternalId
integer
11 caracteres
ID do Contrato/Venda no cel_cash.
Exemplo: "1".
paymentBillIntegrationId
string
255 caracteres
ID de integração informado ao cadastrar o Contrato/Venda pelo parâmetro "integrationId".
ID do contrato/venda no seu sistema.
Exemplo: "1".
transactionInternalId
integer
11 caracteres
ID da transação dentro do sistema
Exemplo: "1".
transactionIntegrationId
integer
11 caracteres
ID da transação que é utilizado para relacionar seu sistema com o cel_cash.
ID da transação no seu sistema.
Exemplo: "1".
payday
date
YYYY-mm-dd
Data de vencimento da transação.
Exemplo: "2020-09-21".
value
decimal
Valor da transação
Exemplo: "80.00".
additionalInfo
string
255 caracteres
Observações sobre a transação, apenas para controle interno no sistema.
Exemplo: "Transação de teste".

NOTAS

82 - Um dos parâmetros, "paymentBillInternalId" ou "paymentBillIntegrationId", é necessario ser informado, logo, os mesmos estão em ordem de relevância.
83 - Um dos parâmetros, "transactionInternalId" ou "transactionIntegrationId", é necessario ser informado, logo, os mesmos estão em ordem de relevância.
84 - Caso não enviado os parâmetros "payday","value" e "additionalInfo", estes não serão alterados.
post
https://app.sandbox.cel.cash/webservice/updateTransactionInfo
{ "Auth": { "galaxId": "5473", "galaxHash": "83Mw5u8988Qj6fZqS4Z8K7LzOo1j28S706R0BeFe" } ,"Request": {"paymentBillIntegrationId": "1","transactionInternalId": "1","payday": "2020-09-21","value": "80.00"} }
{"type": "true","message": "Transação alterada com sucesso."}

/chargeBackTransaction

Método utilizado para estornar transações desejadas na operadora que foi realizada a cobrança.

Parâmetros

transactionInternalId
integer
11 caracteres
Obrigatorio
ID da transação no cel_cash.
Exemplo: "1".

NOTAS

85 - O ID da transação para utilizar no parâmetro "transactionInternalId" pode ser obtido utilizando os resultados dos métodos de busca de transações.
post
https://app.sandbox.cel.cash/webservice/chargeBackTransaction
{ "Auth": { "galaxId": "5473", "galaxHash": "83Mw5u8988Qj6fZqS4Z8K7LzOo1j28S706R0BeFe" } ,"Request": {"transactionInternalId": "1"} }
{"type": "true","message": "Transação estornada com sucesso."}

/cancelTransaction

Método utilizado para cancelar uma transação que ainda não foi capturada.

Parâmetros

transactionInternalId
integer
11 caracteres
ID da transação no cel_cash.
Exemplo: "1".
transactionIntegrationId
string
255 caracteres
ID da transação que é utilizado para relacionar seu sistema com o cel_cash.
ID da transação no seu sistema.
Exemplo: "1A".

NOTAS

86 - É obrigatório o uso de apenas um dos parâmetros citados acima, logo, os mesmos estão em ordem de relevância.
87 - O ID da transação para utilizar no parâmetro "transactionInternalId" pode ser obtido utilizando os resultados dos métodos de busca de transações.
post
https://app.sandbox.cel.cash/webservice/cancelTransaction
{ "Auth": { "galaxId": "5473", "galaxHash": "83Mw5u8988Qj6fZqS4Z8K7LzOo1j28S706R0BeFe" } ,"Request": {"transactionInternalId": "1"} }
{"type": "true","message": "Transação cancelada com sucesso."}

/payedExternalTransaction

Método utilizado para alterar o status de uma transação para "Paga fora do sistema".

Parâmetros

transactionInternalId
integer
11 caracteres
ID da transação no cel_cash.
Exemplo: "1".
transactionIntegrationId
integer
11 caracteres
ID da transação que é utilizado para relacionar seu sistema com o cel_cash.
ID da transação no seu sistema.
Exemplo: "1A".

NOTAS

88 - É obrigatório o uso de apenas um dos parâmetros citados acima, logo, os mesmos estão em ordem de relevância.
89 - O ID da transação para utilizar no parâmetro "transactionInternalId" pode ser obtido utilizando os resultados dos métodos de busca de transações.
post
https://app.sandbox.cel.cash/webservice/payedExternalTransaction
{ "Auth": { "galaxId": "5473", "galaxHash": "83Mw5u8988Qj6fZqS4Z8K7LzOo1j28S706R0BeFe" } ,"Request": {"transactionInternalId": "1"} }
{"type": "true","message": "Status da transação alterado com sucesso."}

/retryTransaction

Reenvia uma transação utilizando informações do cliente, Contrato/Venda e da transação.

Parâmetros

customerInternalId
string
255 caracteres
ID do cliente no cel_cash.
Exemplo: "1".
customerIntegrationId
string
255 caracteres
ID de integração utilizado para relacionar seu sistema com o cel_cash.
ID do cliente no seu sistema.
Exemplo: "1".
paymentBillInternalId
string
255 caracteres
ID do Contrato/Venda no cel_cash.
Exemplo: "1".
paymentBillIntegrationId
integer
11 caracteres
ID do Contrato/Venda que é utilizado para relacionar seu sistema com o cel_cash.
ID do Contrato/Venda no seu sistema.
Exemplo: "1".
transactionInternalId
integer
11 caracteres
ID da transação no cel_cash.
Exemplo: "1".
transactionIntegrationId
string
255 caracteres
ID da transação que é utilizado para relacionar seu sistema com o cel_cash.
ID da transação no seu sistema.
Exemplo: "1A".

NOTAS

90 - Um dos parâmetros, "customerInternalId" ou "customerIntegrationId", é necessario ser informado.
91 - Um dos parâmetros, "paymentBillInternalId" ou "paymentBillIntegrationId", é necessario ser informado.
92 - Um dos parâmetros, "transactionInternalId" ou "transactionIntegrationId", é necessario ser informado.
post
https://app.sandbox.cel.cash/webservice/retryTransaction
{ "Auth": { "galaxId": "5473", "galaxHash": "83Mw5u8988Qj6fZqS4Z8K7LzOo1j28S706R0BeFe" } ,"Request": {"customerInternalId": "1","paymentBillInternalId": "1","transactionInternalId": "1"} }
{"type": "true", "message": "Transação reenviada com sucesso."}

/getAllStatusTransaction

Retorna uma lista com todos os possíveis status das transações dentro do seu sistema.
Este método não necessita de parâmetros na requisição.
post
https://app.sandbox.cel.cash/webservice/getAllStatusTransaction
{ "Auth": { "galaxId": "5473", "galaxHash": "83Mw5u8988Qj6fZqS4Z8K7LzOo1j28S706R0BeFe" } }
{"type":true,"status":[{"name":"captured","displayName":"Capturada na Operadora"},{"name":"denied","displayName":"Negada na Operadora"},{"name":"processError","displayName":"Erro ao processar cobrança"},{"name":"reversed","displayName":"Estornada na Operadora"},{"name":"notSend","displayName":"Ainda não enviada para operadora"},{"name":"cancel","displayName":"Cancelada manualmente"},{"name":"reversedAnotherPlace","displayName":"Estornada fora do sistema "},{"name":"payExternal","displayName":"Paga fora do sistema"},{"name":"cancelByContract","displayName":"Cancelada ao cancelar a cobrança"},{"name":"pendingBoleto","displayName":"Em aberto"},{"name":"payedBoleto","displayName":"Boleto compensado"},{"name":"lessValueBoleto","displayName":"Pago valor menor que o original"},{"name":"moreValueBoleto","displayName":"Pago valor maior que o original"},{"name":"paidDuplicityBoleto","displayName":"Pago em duplicidade"},{"name":"free","displayName":"Isento"},{"name":"authorized","displayName":"Autorizado"},{"name":"notCompensated","displayName":"Boleto baixado por decurso de prazo"},{"name":"pendingAutoDebit","displayName":"Aguardando gerar remessa"},{"name":"inFileAutoDebit","displayName":"Remessa gerada"},{"name":"payedAutoDebit","displayName":"Débito realizado"},{"name":"deniedAutoDebit","displayName":"Débito negado"}]}

/getBoletoList

Retorna todos os boletos pendentes referente ao cliente desejado, que pode ser filtrado por diferentes parâmetros.

Parâmetros

customerInternalId
integer
11 caracteres
ID do cliente no cel_cash.
Exemplo: "1".
customerIntegrationId
string
255 caracteres
ID de integração, informado ao cadastrar o cliente pelo parâmetros "integrationId".
ID do cliente no seu sistema.
Exemplo: "1".
customerDocument
string
16 caracteres
CPF/CNPJ do cliente.
Exemplo: "012.345.678-90".
customerEmail
string
255 caracteres
Email do cliente.
Exemplo: "[email protected]".
paymentBillInternalId
string
255 caracteres
ID interno do Contrato/Venda.
Exemplo: "123".
paymentBillIntegrationId
string
255 caracteres
ID interno, informado ao cadastrar o Contrato/Venda pelo parâmetro "integrationId".
ID do Contrato/Venda no seu sistema.
Exemplo: "123A".

NOTAS

93 - É obrigatório apenas um dos quatro parâmetros citados acima
94 - Somente um destes parâmetros é considerado, logo, os mesmos estão em ordem de relevância.
post
https://app.sandbox.cel.cash/webservice/getBoletoList
{ "Auth": { "galaxId": "5473", "galaxHash": "83Mw5u8988Qj6fZqS4Z8K7LzOo1j28S706R0BeFe" } ,"Request": {"customerInternalId": "1"} }
{"type":"true","boletos":[{"id":"6768","value":"2.55","payday":"2018-05-15","paydayLimit":"2018-06-26","outdated":"true","url":"https://www.urldeboleto.com.br/boleto/424sadaskksakdkasfk6768","bankLine":"03399022070600000000700175601012176650000000255"},{"id":"6769","value":"2.55","payday":"2018-05-15","paydayLimit":"2018-06-26","outdated":"true","url":"https://www.urldeboleto.com.br/boleto/424sadaskksakdkasfk6769","bankLine":"03399022070600000000700175601012176650000000255"},{"id":"6771","value":"2.55","payday":"2018-05-15","paydayLimit":"2018-06-26","outdated":"true","url":"https://www.urldeboleto.com.br/boleto/424sadaskksakdkasfk6771","bankLine":"03399022070600000000700175601012176650000000255"},{"id":"6798","value":"2.55","payday":"2018-05-16","paydayLimit":"2018-05-16","outdated":"true","url":"https://www.urldeboleto.com.br/boleto/424sadaskksakdkasfk6798"},{"id":"6808","value":"2.55","payday":"2018-05-16","paydayLimit":"2018-05-16","outdated":"true","url":"https://www.urldeboleto.com.br/boleto/424sadaskksakdkasfk6808","bankLine":"03399022070600000000700175601012176650000000255"}]}

/captureTransaction

Captura uma transação pré autorizada.

Parâmetros

transactionInternalId
integer
11 caracteres
ID da transação dentro do sistema
Exemplo: "1".
transactionIntegrationId
integer
11 caracteres
ID da transação que é utilizado para relacionar seu sistema com o cel_cash.
ID da transação no seu sistema.
Exemplo: "1".
post
https://app.sandbox.cel.cash/webservice/captureTransaction
{ "Auth": { "galaxId": "5473", "galaxHash": "83Mw5u8988Qj6fZqS4Z8K7LzOo1j28S706R0BeFe" } ,"Request": {"transactionInternalId": "1"} }
{"type":"true","message":"Transação capturada com sucesso."}

Campos personalizados

Área destinada a busca de informações utilizando campos personalizados.

/getPaymentBillInfoCustomFields

Retorna todas as informações do pagamento e suas transações utilizando os filtros de campos personalizados.

Parâmetros

CustomFields
Obrigatorio
Informações para serem pesquisadas dentro dos campos personalizados dos Contratos/Venda.
Deve ser utilizado a TAG gerada para campo personalizado dentro do sistema.
CP_FILIAL
string
Valor a ser pesquisado no campo personalizado de filial.
Exemplo: "Belo horizonte".
CP_FILIAL_NUMERO
string
Valor a ser pesquisado no campo personalizado de filial.
Exemplo: "21514".
startDate
date
YYYY-mm-dd
Obrigatorio
Data inicial que deseja filtrar os resultados.
Exemplo: "2018-01-10".
endDate
date
YYYY-mm-dd
Obrigatorio
Data final que deseja filtrar os resultados.
Exemplo: "2018-12-15".
typeDate
string
Obrigatorio
Tipo de data a filtrar.
Exemplo: "dateOfLastUpdate".

Opções

Opções disponiveis para uso em "typeDate"
Valor Descrição
dateOfLastUpdate Data em que a transação foi capturada ou negada.
expirationDateOfTransaction Data de vencimento da transação.
post
https://app.sandbox.cel.cash/webservice/getPaymentBillInfoCustomFields
{ "Auth": { "galaxId": "5473", "galaxHash": "83Mw5u8988Qj6fZqS4Z8K7LzOo1j28S706R0BeFe" } ,"Request": {"CustomFields": {"CP_FILIAL": "Belo horizonte","CP_FILIAL_NUMERO": "21514"},"startDate": "2018-01-10","endDate": "2018-12-15","typeDate": "dateOfLastUpdate"} }
{"type":"true","paymentBill":{"internalId":"9908","integrationId":"","periodicity":"single","quantity":"1","value":"100.50","dateFirst":"2019-02-01","customerInternalId":"806","customerIntegrationId":"1564564","customerName":"ADRIAO FERREIRA CALDEIRA","cardTruncate":"null","status":"active","statusDescription":"Ativa","transactions":[{"internalId":"69246","value":"100.50","payday":"2019-02-01","lastUpdateDate":"2019-02-01 10:11:31","authorizationCode":"","status":"pendingBoleto","statusDescription":"Em aberto","boleto":"null","boletoBankLine":"null","boletoBankNumber":"null","qrCodePix":null,"imageQrCodePix":null,"pageQrCodePix":null}]}}

Antifraude

Área destinada a implementação de antifraude.
Atenção! Para a transação ser enviada para antifraude é necessário enviar corretamente os campos:
Nome completo do cliente
E-mail do cliente
CPF/CNPJ do cliente
Telefone e/ou celular do cliente
Endereço completo do cliente

/getFingerPrintJs

Retorna a URL do javascript que deverá ser adicionado em todas as páginas de seu e-commerce após o cliente logado.

Parâmetros

sessionId
string
255 caracteres
Obrigatorio
Código único do usuário logado no sistema do seu e-commerce.
Exemplo: "65a7e35f4a6s7dfa46a78sd".

NOTAS

95 - Aconselhamos que o sessionId seja preenchido com a concatenação do seu galaxId, CPF/CNPJ do cliente logado e o número do pedido do cliente em seu e-commerce.
96 - O sessionId deverá ter no mínimo 20 caracteres e no máximo 80, permitindo apenas letras e números.
post
https://app.sandbox.cel.cash/webservice/getFingerPrintJs
{ "Auth": { "galaxId": "5473", "galaxHash": "83Mw5u8988Qj6fZqS4Z8K7LzOo1j28S706R0BeFe" } ,"Request": {"sessionId": "65a7e35f4a6s7dfa46a78sd"} }
{"type": "true", "link": "https://app.galaxpay.com.br/galaxpay/finger-print/65a7e35f4a6s7dfa46a78sd"}

Webhooks

Webhook é uma maneira de uma aplicação fornecer informações, em tempo real, para outras aplicações.
Dentro do sistema será possível configurar o endpoint que irá receber o payload.
IMPORTANTE: Verifique se o seu endpoint está disponível para receber requisições.
Geralmente as requisições são recebidas via porta 80 (HTTP) ou 443 (HTTPS).

/getSendedWebhooks

Busca os webhooks enviados de acordo com o período informado

Parâmetros

event
string
255 caracteres
Evento
Exemplo: "transaction.status".
startDate
date
YYYY-mm-dd
Obrigatorio
Data de início do filtro.
Exemplo: "2019-10-15".
endDate
date
YYYY-mm-dd
Obrigatorio
Data final do filtro.
Exemplo: "2019-10-26".
post
https://app.sandbox.cel.cash/webservice/getSendedWebhooks
{ "Auth": { "galaxId": "5473", "galaxHash": "83Mw5u8988Qj6fZqS4Z8K7LzOo1j28S706R0BeFe" } ,"Request": {"event": "transaction.status","startDate": "2019-10-15","endDate": "2019-10-26"} }
{"type":"true","data":{"event":"transaction.status","url":"http://app.galaxpay.com/retorno-webhook.php","info":{"billInternalId":"12919","billIntegrationId":"4435121687","transactionInternalId":"82999","customerIntegrationId":"6ee29628-f350-490f-bc65-7eae04dae808","customerInternalId":"6626","value":"10","payday":"2019-10-21","authorizationCode":"141573","status":"captured","statusInsertdate":"2019-10-21 09:14:21","statusDescription":"Capturada na Operadora","transactionIntegrationId":"62174aaf-6e76-4309-bfba-54945317e349","installmentNumber":"1"},"insertdate":"2019-10-21 09:14:21"}}

Retentativas

O cel_cash irá efetuar 8 tentativas de comunicação com seu endpoint, até que sua aplicação responda com um código HTTP 2xx.
As retentativas são realizadas em intervalos progressivos durante aproximadamente 48 horas até obter a resposta esperada. Caso o seu servidor não responda com o código 2xx em 48 horas, o cel_cash não irá mais processar esta requisição.

Eventos

Abaixo se encontra a lista de eventos que ao acontecer, o cel_cash irá enviar as informações para seu endpoint.
transaction.status
Ao atualizar o status da transação.
bill.generatePaper
Ao termino da geração do carnê utilizando o método "/getCarneList".
bill.generatePaperCustom
Ao termino da geração do carnê personalizado utilizando o método "/getCarneCustom".
transaction.conciliation
Ao solicitar informações de conciliação bancária pelo ID da transação.
sale.updateTransactions
Ao encerrar uma venda.

Exemplo

O intuito de nossas requisições é fornecer o maior número de informações possiveis para que seu sistema consiga realizar todas as ações necessárias com o que foi recebido.
Ao lado, segue um exemplo de informações enviadas no evento "transaction.status".
{ "webhookId": "23132564564", "event": "transaction.status", "company": { "id": "20", "name": "Empresa de teste" }, "data": { "billInternalId": "9", "billIntegrationId": "45D2A", "transactionInternalId": "2058", "value": "55.20", "payday": "2018-08-10", "authorizationCode": "TID123423", "status": "captured", "statusInsertdate": "2018-08-10 10:08:15", "statusDescription": "Capturada na operadora" } }
Ao lado, segue um exemplo de informações enviadas no evento "sale.updateTransactions".
{ "webhookId": "23132564564", "event": "sale.updateTransactions", "company": { "id": "20", "name": "Empresa de teste" }, "data": { "billInternalId": "9", "billIntegrationId": "45D2A", "totalValue": 100, "transactions": { "transactionInternalId": "2058", "transactionIntegrationId": "AF224A", "value": "100", "payday": "2018-08-10", "authorizationCode": "TID123423", "status": "captured", "statusInsertdate": "2018-08-10 10:08:15", "statusDescription": "Capturada na operadora", "installmentNumber": 1, } } }

Parâmetros

Abaixo se encontra a lista dos parâmetros e de suas explicações, que podem ser utilizados no envio do webhook até o endpoint.
webhookId
ID único do webhook, este ID não se repete.
event
Evento utilizado para disparar o webhook
company.id
ID da empresa
company.name
Nome da empresa
data.billInternalId
ID do Contrato/Venda dentro do cel_cash
data.billIntegrationId
ID de integração do Contrato/Venda
data.customerInternalId
ID do cliente dentro do cel_cash
data.customerIntegrationId
ID de integração do cliente
data.transactionInternalId
ID da transação no cel_cash
data.transactionIntegrationId
ID de integração da transação
data.value
Valor da transação
data.payday
Data de vencimento da transação
data.authorizationCode
Código de autorização da transação
data.status
Status da transação
data.statusInsertdate
Data que o status foi cadastrado na transação
data.statusDescription
Descrição do status da transação
data.boleto
URL do boleto
data.boletoBankLine
Linha digitável do boleto
data.boletoBankNumber
Nosso número do boleto

Pacote PHP Básico

Abaixo você encontrará o download de um pacote básico de programação com os principais métodos implementados, em uma programação estruturada em PHP de fácil entendimento, para que o desenvolvimento da integração seja o mais fácil possivel.
Download

Ajuda

Ficou com alguma dúvida sobre a integração? Precisa de suas credenciais de integração ou não possuímos ainda o que deseja?
Não deixe de entrar em contato com a gente! Procuramos oferecer as melhores soluções para nossos clientes e estamos abertos a feedbacks, sugestões e considerações sobre nosso produto para fortalecer ainda mais a nossa parceria.

Entre em contato

Conheça nosso atendimento personalizado e surpreenda-se!
Estamos prontos para atendê-lo por telefone, e-mail ou skype.

Segunda a sexta de 08h às 18h.
live:equipe.galaxpay
4004-2967

Documentação

13/12/2023