/
APIs para consultar Saldo de Contas Pré-pagas

APIs para consultar Saldo de Contas Pré-pagas

spaolid/extrato/saldo

Servem para o parceiro que integrou as APIs e APPs da Directcall manter o usuário da sua aplicação informado sobre o Saldo de sua Conta PRÉ-PAGA, na Directcall. 

 

 

 

 

DESCRIÇÃO

Este método permite consultar o saldo de uma conta pré-paga na Directcall.

NOTA: Independente disso a Directcall avisa os clientes que estão com saldo baixo por e-mail, com links que permitem a recarga a partir de boleto, cartões de crédito, etc. Os clientes que autorizaram a recarga automática são apenas informados sobre a previsão de débito automático por saldo baixo, nos seus cartões de crédito.

ESTRUTURA DA URL

https://api.directcallsoft.com/extrato/saldo

VERSÃO

1

MÉTODO

POST

PARÂMETROS

access_token obrigatório Chave de acesso ao método, para saber como obter clique aqui

formato opcional Opção de retorno da API, podendo ser JSON ou XML (se não informado, JSON será o padrão)

RETORNO

api Origem API que está sendo usada

modulo Módulo que está sendo chamado

status Mensagem de status

codigo Código de retorno - Clique aqui para listar os códigos e suas descrições

msg Mensagem de resposta da API

result Lista de dados sobre a conta

- sms_nacional_com_short_number (Número estimado de quantos SMS's nacionais podem ser enviados com Short Number)

 

Exemplo de resposta em JSON
{ "api": "users", "modulo": "user-balance", "status": "ok", "codigo": "001", "msg": "Dados retornados com sucesso", "result": { "sms_nacional_com_short_number": 122, "pre-pago": true, "saldo": "20.69", "moeda": "R$" } }

Exemplo em PHP para verificar saldo

Validade dos tokens: Os tokens de acesso têm uma validade limitada, por isso convém que o sistema criado tenha em conta estes timings para que possa desenvolver rotinas de requisação de novos tokens.