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 | |
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.