# CardHub Documentation
> Documentation for CardHub
## Guides
- [Conciliação de vendas](https://developers.cardhub.com.br/docs/conciliação-de-venda.md)
## API Reference
- [Autenticação](https://developers.cardhub.com.br/reference/informações-de-acesso.md)
- [Estabelecimentos](https://developers.cardhub.com.br/reference/url-do-ambiente-de-homologação-para-consumo.md)
- [Consultar Produtos](https://developers.cardhub.com.br/reference/listar-produtos.md): Utilize essa operação para obter os Produtos habilitados para venda em seu Estabelecimento.
- [Consultar Transações](https://developers.cardhub.com.br/reference/consultar-transacao-voucher.md): Utilize essa operação para consultar as transações realizadas por um determinado estabelecimento.
- [Consultar Transações Paginada](https://developers.cardhub.com.br/reference/consultar-transacoes-paginadas-multiprodutos.md): Utilize essa operação para consultar de forma paginada as transações de vendas realizadas por um determinado estabelecimento. **Obs.**: As transações com status AUTORIZADA (pendente) não estão disponíveis nessa listagem. **A quantidade aceita de registros a retornar fica entre 1000 até 4000, veja a seguir um exemplo de como aplicar a paginação ({registroInicial}/{qtdRegistrosRetornados}):** 1/4000: serão retornados os registros de 1 até 4000. 4000/4000: serão retornados os registros de 4001 até 8000. 8000/4000: serão retornados os registros de 8001 até 12000. 12000/4000: serão retornados os registros de 12001 até 16000. Execute a consulta até que o campo 'transacoes' venha vazio, indicando que todas as transações do dia foram recuperadas.
- [Exemplo - Consulta Transação Paginada](https://developers.cardhub.com.br/reference/exemplo-consulta-transação-paginada.md): Segue abaixo um exemplo de uma consulta de transações paginadas:
- [Consultar Transações Conciliação](https://developers.cardhub.com.br/reference/conciliacao-transacoes-multiprodutos.md): Utilize essa operação para consultar as transações de vendas para fins de conciliação. **A quantidade aceita de registros a retornar fica entre 1000 até 4000, veja a seguir um exemplo de como aplicar a paginação ({registroInicial}/{qtdRegistrosRetornados}):** 1/4000: serão retornados os registros de 1 até 4000. 4000/4000: serão retornados os registros de 4001 até 8000. 8000/4000: serão retornados os registros de 8001 até 12000. 12000/4000: serão retornados os registros de 12001 até 16000. Execute a consulta até que o campo 'transacoes' venha vazio, indicando que todas as transações do dia foram recuperadas.
- [Limite Saldo](https://developers.cardhub.com.br/reference/multiprodutos-listar-limite-saldo.md): Utilize essa operação para obter os Limites e respectivos Saldos de seu Estabelecimento.
- [Listar Cobranças](https://developers.cardhub.com.br/reference/multiprodutos-listar-cobrancas.md): Utilize essa operação para obter as Cobranças de seu Estabelecimento.
- [Logo dos Produtos](https://developers.cardhub.com.br/reference/logo-dos-produtos.md)
- [Solicitar Venda](https://developers.cardhub.com.br/reference/solicitar-venda-telecom.md): Utilize essa operação para solicitar a venda dos produtos Telecom. Este serviço faz apenas a SOLICITAÇÃO da venda, portanto, se na resposta desta operação o campo status for igual a AUTORIZADA, na sequência a confirmação da transação deve ser enviada através da operação: Confirmar Venda.
- [Confirmar Venda](https://developers.cardhub.com.br/reference/confirmar-venda-telecom.md): Utilize essa operação para efetivar/confirmar uma transação de venda solicitada anteriormente pela operação solicitarVenda. A transação uma vez sendo Confirmada ou Cancelada, seu status não poderá mais ser alterado, e mesmo que a operação seja invocada para tal ação, não surtirá efeito!
- [Cancelar Venda](https://developers.cardhub.com.br/reference/cancelar-venda-telecom.md): Utilize essa operação para cancelar uma transação de venda solicitada anteriormente pela operação solicitarVenda. A transação uma vez sendo Confirmada ou Cancelada, seu status não poderá mais ser alterado, e mesmo que a operação seja invocada para tal ação, não surtirá efeito!
- [Consultar Valores por DDD](https://developers.cardhub.com.br/reference/consultar-valores-ddd.md): Utilize essa operação para obter os valores disponíveis para vendas de acordo o DDD (localidade). Válido apenas para produtos com negócio RECARGA TELEFONE.
- [Roteiro de Venda](https://developers.cardhub.com.br/reference/roteiro-de-venda-esim.md)
- [Consultar Planos](https://developers.cardhub.com.br/reference/consulta-planos-esim.md): Utilize essa operação para consultar os planos oferecidos.
- [Solicitar Venda](https://developers.cardhub.com.br/reference/solicitar-venda-esim.md): Utilize essa operação para solicitar a venda dos produtos disponíveis no estabelecimento.
- [Consultar Dados](https://developers.cardhub.com.br/reference/consulta-pgto-cts-getdados.md): Consulta dados da cobrança
Parametros->estabelecimento: Token do Estabelecimento;codbarras: Código de barras;valor: Valor da cobrança.
- [Consultar Status](https://developers.cardhub.com.br/reference/consulta-pgto-cts-status.md): Consulta status da transação
Parametros->estabelecimento: Token do Estabelecimento;transacaoid: Id da transação.
- [Pagar Boleto](https://developers.cardhub.com.br/reference/solicitar-pgto-cts-boleto-wl.md): Utilize essa operação para pagar um Boleto.
- [Pagar Tributo](https://developers.cardhub.com.br/reference/solicitar-pgto-cts-tributo-wl.md): Utilize essa operação para pagar um Tributo.
- [Consultar Produtos e Valores disponíveis](https://developers.cardhub.com.br/reference/consulta-dinamica-tv-pré-e-streaming.md): Utilize essa operação para obter os valores e os produtos negociados para Tv Pré Paga.
- [Solicitar Venda](https://developers.cardhub.com.br/reference/solicitar-venda-tv.md): Utilize essa operação para solicitar a venda dos produtos de TV pré paga. Este serviço faz apenas a SOLICITAÇÃO da venda, portanto, se na resposta desta operação o campo status for igual a AUTORIZADA, na sequência a confirmação da transação deve ser enviada através da operação: Confirmar/Cancelar Venda.
- [Confirmar Venda](https://developers.cardhub.com.br/reference/confirmar-venda-tv-pré-e-streaming.md): Utilize essa operação para efetivar/confirmar uma transação de venda solicitada anteriormente pela operação solicitarVenda. A transação uma vez sendo Confirmada ou Cancelada, seu status não poderá mais ser alterado, e mesmo que a operação seja invocada para tal ação, não surtirá efeito!
- [Cancelar Venda](https://developers.cardhub.com.br/reference/cancelar-venda-tv-pré-e-streaming.md): Utilize essa operação para cancelar uma transação de venda solicitada anteriormente pela operação solicitarVenda. A transação uma vez sendo Confirmada ou Cancelada, seu status não poderá mais ser alterado, e mesmo que a operação seja invocada para tal ação, não surtirá efeito!
- [Solicitar Venda](https://developers.cardhub.com.br/reference/solicitar-venda-voucher.md): Utilize essa operação para solicitar a venda dos produtos Voucher. Este serviço faz apenas a SOLICITAÇÃO da venda, portanto, se na resposta desta operação o campo status for igual a AUTORIZADA, na sequência a confirmação da transação deve ser enviada através da operação: Confirmar/Cancelar Venda.
- [Confirmar Venda](https://developers.cardhub.com.br/reference/confirmar-venda-voucher.md): Utilize essa operação para efetivar/confirmar uma transação de venda solicitada anteriormente pela operação solicitarVenda. A transação uma vez sendo Confirmada ou Cancelada, seu status não poderá mais ser alterado, e mesmo que a operação seja invocada para tal ação, não surtirá efeito!
- [Cancelar Venda](https://developers.cardhub.com.br/reference/cancelar-venda-voucher.md): Utilize essa operação para cancelar uma transação de venda solicitada anteriormente pela operação solicitarVenda. A transação uma vez sendo Confirmada ou Cancelada, seu status não poderá mais ser alterado, e mesmo que a operação seja invocada para tal ação, não surtirá efeito!
- [Consultar informações complementares](https://developers.cardhub.com.br/reference/consulta-dinamica-e-gift.md): Busca informações complementares de um determinado Produto, quando necessário.
- [Solicitar Venda](https://developers.cardhub.com.br/reference/solicitar-venda-e-gift.md): Utilize essa operação para solicitar a venda dos produtos E-Gift. Este serviço faz apenas a SOLICITAÇÃO da venda, portanto, se na resposta desta operação o campo status for igual a AUTORIZADA, na sequência a confirmação da transação deve ser enviada através da operação: Confirmar Venda.
- [Confirmar Venda](https://developers.cardhub.com.br/reference/confirmar-venda-e-gift.md): Utilize essa operação para efetivar/confirmar uma transação de venda solicitada anteriormente pela operação solicitarVenda. A transação uma vez sendo Confirmada ou Cancelada, seu status não poderá mais ser alterado, e mesmo que a operação seja invocada para tal ação, não surtirá efeito!
- [Cancelar Venda](https://developers.cardhub.com.br/reference/cancelar-venda-e-gift.md): Utilize essa operação para cancelar uma transação de venda solicitada anteriormente pela operação solicitarVenda. A transação uma vez sendo Confirmada ou Cancelada, seu status não poderá mais ser alterado, e mesmo que a operação seja invocada para tal ação, não surtirá efeito!
- [Consultar valores](https://developers.cardhub.com.br/reference/consulta-valores-sptrans.md): Busca informações complementares dos produtos SPTrans.
- [Solicitar Venda](https://developers.cardhub.com.br/reference/solicitar-venda-sptrans.md): Utilize essa operação para solicitar a venda do Produto SPTrans. Este serviço faz apenas a SOLICITAÇÃO da venda, portanto, se na resposta desta operação o campo status for igual a AUTORIZADA, na sequência a confirmação da transação deve ser enviada através da operação: Confirmar/Cancelar Venda.
- [Confirmar Venda](https://developers.cardhub.com.br/reference/confirmar-venda-sptrans.md): Utilize essa operação para efetivar/confirmar uma transação de venda solicitada anteriormente pela operação solicitarVenda. A transação uma vez sendo Confirmada ou Cancelada, seu status não poderá mais ser alterado, e mesmo que a operação seja invocada para tal ação, não surtirá efeito!
- [Cancelar Venda](https://developers.cardhub.com.br/reference/cancelar-venda-sptrans.md): Utilize essa operação para cancelar uma transação de venda solicitada anteriormente pela operação solicitarVenda. A transação uma vez sendo Confirmada ou Cancelada, seu status não poderá mais ser alterado, e mesmo que a operação seja invocada para tal ação, não surtirá efeito!
- [Validar Cartão](https://developers.cardhub.com.br/reference/valida-cartão.md): Para realizar a venda do produto Guaicurus Digital pode-se opcionalmente consumir a operação de validação do cartão do usuário antes de realizar a venda.
- [Solicitar Venda](https://developers.cardhub.com.br/reference/solicitar-venda-guaicurus.md): Utilize essa operação para solicitar a venda do Produto Guaicurus. Este serviço faz apenas a SOLICITAÇÃO da venda, portanto, se na resposta desta operação o campo status for igual a AUTORIZADA, na sequência a confirmação da transação deve ser enviada através da operação: Confirmar/Cancelar Venda.
- [Confirmar Venda](https://developers.cardhub.com.br/reference/confirmar-venda-guaicurus.md): Utilize essa operação para efetivar/confirmar uma transação de venda solicitada anteriormente pela operação solicitarVenda. A transação uma vez sendo Confirmada ou Cancelada, seu status não poderá mais ser alterado, e mesmo que a operação seja invocada para tal ação, não surtirá efeito!
- [Cancelar Venda](https://developers.cardhub.com.br/reference/cancelar-venda-guaicurus.md): Utilize essa operação para cancelar uma transação de venda solicitada anteriormente pela operação solicitarVenda. A transação uma vez sendo Confirmada ou Cancelada, seu status não poderá mais ser alterado, e mesmo que a operação seja invocada para tal ação, não surtirá efeito!
- [Códigos de Situação de Envio](https://developers.cardhub.com.br/reference/listagem-dos-possíveis-códigos-de-erros-retornados-pela-api-copy.md): Segue abaixo a tabela que relaciona o código de resposta da situação do envio de sms retornado no campo **situacaoEnvio** do payload de resposta da solicitação POST /enviar.
- [Consultar Sorteio](https://developers.cardhub.com.br/reference/consulta-dinamica-tele-sena.md): Busca informações complementares de um determinado Produto, quando necessário.
- [Solicitar Venda](https://developers.cardhub.com.br/reference/solicitar-venda-tele-sena.md): Utilize essa operação para solicitar a venda do Produto Tele Sena. Este serviço faz apenas a SOLICITAÇÃO da venda, portanto, se na resposta desta operação o campo status for igual a AUTORIZADA, na sequência a confirmação da transação deve ser enviada através da operação: Confirmar/Cancelar Venda.
- [Confirmar Venda](https://developers.cardhub.com.br/reference/confirmar-venda-tele-sena.md): Utilize essa operação para efetivar/confirmar uma transação de venda solicitada anteriormente pela operação solicitarVenda. A transação uma vez sendo Confirmada ou Cancelada, seu status não poderá mais ser alterado, e mesmo que a operação seja invocada para tal ação, não surtirá efeito!
- [Cancelar Venda](https://developers.cardhub.com.br/reference/cancelar-venda-tele-sena.md): Utilize essa operação para cancelar uma transação de venda solicitada anteriormente pela operação solicitarVenda. A transação uma vez sendo Confirmada ou Cancelada, seu status não poderá mais ser alterado, e mesmo que a operação seja invocada para tal ação, não surtirá efeito!
- [Consultar valores do sorteio](https://developers.cardhub.com.br/reference/consulta-dinamica-ms-cap.md): Busca informações complementares de um determinado Produto, quando necessário.
- [Solicitar Venda](https://developers.cardhub.com.br/reference/solicitar-venda-ms-cap.md): Utilize essa operação para solicitar a venda do Produto MS CAP. Este serviço faz apenas a SOLICITAÇÃO da venda, portanto, se na resposta desta operação o campo status for igual a AUTORIZADA, na sequência a confirmação da transação deve ser enviada através da operação: Confirmar/Cancelar Venda.
- [Confirmar Venda](https://developers.cardhub.com.br/reference/confirmar-venda-ms-cap.md): Utilize essa operação para efetivar/confirmar uma transação de venda solicitada anteriormente pela operação solicitarVenda. A transação uma vez sendo Confirmada ou Cancelada, seu status não poderá mais ser alterado, e mesmo que a operação seja invocada para tal ação, não surtirá efeito!
- [Cancelar Venda](https://developers.cardhub.com.br/reference/cancelar-venda-ms-cap.md): Utilize essa operação para cancelar uma transação de venda solicitada anteriormente pela operação solicitarVenda. A transação uma vez sendo Confirmada ou Cancelada, seu status não poderá mais ser alterado, e mesmo que a operação seja invocada para tal ação, não surtirá efeito!
- [Roteiro de Venda](https://developers.cardhub.com.br/reference/roteiro-de-venda-8.md)
- [Consultar Ediçoes](https://developers.cardhub.com.br/reference/consulta-edicoes-redepos.md): Busca edições do Produto
- [Consultar Produtos](https://developers.cardhub.com.br/reference/consulta-tipos-produtos-redepos.md): Busca tipos de produtos disponíveis
- [Consultar Valores](https://developers.cardhub.com.br/reference/consulta-valores-redepos.md): Busca valores do Produto
- [Solicitar Venda](https://developers.cardhub.com.br/reference/solicitar-venda-redepos.md): Utilize essa operação para solicitar a venda dos Produtos REDEPOS. Este serviço faz apenas a SOLICITAÇÃO da venda, portanto, se na resposta desta operação o campo status for igual a AUTORIZADA, na sequência a confirmação da transação deve ser enviada através da operação: Confirmar/Cancelar Venda.
- [Confirmar Venda](https://developers.cardhub.com.br/reference/confirmar-venda-redepos.md): Utilize essa operação para efetivar/confirmar uma transação de venda solicitada anteriormente pela operação solicitarVenda. A transação uma vez sendo Confirmada ou Cancelada, seu status não poderá mais ser alterado, e mesmo que a operação seja invocada para tal ação, não surtirá efeito!
Parametros:
vApi --> Versão da API, valores possíveis: 20190925 (atual).
- [Cancelar Venda](https://developers.cardhub.com.br/reference/cancelar-venda-redepos.md): Utilize essa operação para cancelar uma transação de venda solicitada anteriormente pela operação solicitarVenda. A transação uma vez sendo Confirmada ou Cancelada, seu status não poderá mais ser alterado, e mesmo que a operação seja invocada para tal ação, não surtirá efeito!
Parametros:
vApi --> Versão da API, valores possíveis: 20190925 (atual).
- [Roteiro de Venda](https://developers.cardhub.com.br/reference/roteiro-de-venda-palpitedomilhao.md)
- [Solicitar Venda](https://developers.cardhub.com.br/reference/solicitar-venda-palpitedomilhao.md): Utilize essa operação para solicitar a venda de qualquer produto disponível no estabelecimento. Este serviço faz apenas a SOLICITAÇÃO da venda, portanto, se na resposta desta operação o campo status for igual a AUTORIZADA, na sequência a confirmação da transação deve ser enviada através da operação: Confirmar/Cancelar Venda.
- [Confirmar Venda](https://developers.cardhub.com.br/reference/confirmar-venda-palpitedomilhao.md): Utilize essa operação para efetivar/confirmar uma transação de venda solicitada anteriormente pela operação solicitarVenda. A transação uma vez sendo Confirmada ou Cancelada, seu status não poderá mais ser alterado, e mesmo que a operação seja invocada para tal ação, não surtirá efeito!.
- [Cancelar Venda](https://developers.cardhub.com.br/reference/cancelar-venda-palpitedomilhao.md): Utilize essa operação para cancelar uma transação de venda solicitada anteriormente pela operação solicitarVenda. A transação uma vez sendo Confirmada ou Cancelada, seu status não poderá mais ser alterado, e mesmo que a operação seja invocada para tal ação, não surtirá efeito!
- [Roteiro de Venda](https://developers.cardhub.com.br/reference/roteiro-de-venda-copy-2.md)
- [Consultar Valores](https://developers.cardhub.com.br/reference/consulta-sorteios-familhaodohuck.md): Utilize essa operação para consultar os valores do sorteios.
- [Solicitar Venda](https://developers.cardhub.com.br/reference/solicitar-venda-familhaodohuck.md): Utilize essa operação para solicitar a venda de qualquer produto disponível no estabelecimento. Este serviço faz apenas a SOLICITAÇÃO da venda, portanto, se na resposta desta operação o campo status for igual a AUTORIZADA, na sequência a confirmação da transação deve ser enviada através da operação: Confirmar/Cancelar Venda.
- [Confirmar Venda](https://developers.cardhub.com.br/reference/confirmar-venda-familhaodohuck.md): Utilize essa operação para efetivar/confirmar uma transação de venda solicitada anteriormente pela operação solicitarVenda. A transação uma vez sendo Confirmada ou Cancelada, seu status não poderá mais ser alterado, e mesmo que a operação seja invocada para tal ação, não surtirá efeito!.
- [Cancelar Venda](https://developers.cardhub.com.br/reference/cancelar-venda-familhaodohuck.md): Utilize essa operação para cancelar uma transação de venda solicitada anteriormente pela operação solicitarVenda. A transação uma vez sendo Confirmada ou Cancelada, seu status não poderá mais ser alterado, e mesmo que a operação seja invocada para tal ação, não surtirá efeito!
- [Consultar Valores](https://developers.cardhub.com.br/reference/consulta-valores-starbem.md): Busca valores do produto starbem
- [Solicitar Venda](https://developers.cardhub.com.br/reference/solicitar-venda-starbem.md): Utilize essa operação para solicitar a venda dos Produtos STARBEM. Este serviço faz apenas a SOLICITAÇÃO da venda, portanto, se na resposta desta operação o campo status for igual a AUTORIZADA, na sequência a confirmação da transação deve ser enviada através da operação: Confirmar/Cancelar Venda.
- [Confirmar Venda](https://developers.cardhub.com.br/reference/confirmar-venda-starbem.md): Utilize essa operação para efetivar/confirmar uma transação de venda solicitada anteriormente pela operação solicitarVenda. A transação uma vez sendo Confirmada ou Cancelada, seu status não poderá mais ser alterado, e mesmo que a operação seja invocada para tal ação, não surtirá efeito!
- [Cancelar Venda](https://developers.cardhub.com.br/reference/cancelar-venda-starbem.md): Utilize essa operação para cancelar uma transação de venda solicitada anteriormente pela operação solicitarVenda. A transação uma vez sendo Confirmada ou Cancelada, seu status não poderá mais ser alterado, e mesmo que a operação seja invocada para tal ação, não surtirá efeito!
## Changelog
- [Welcome to Card Hub](https://developers.cardhub.com.br/changelog/welcome-to-card-hub.md)