Skip to end of metadata
Go to start of metadata

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. 

Veja também: APIs e URLs para habilitar TESTE GRÁTIS no seu software.



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 URLhttps://api.directcallsoft.com/extrato/saldo
VERSÃO1
MÉTODOPOST
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)

- sms_nacional_sem_short_number (Número estimado de quantos SMS's nacionais podem ser enviados sem 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,
        "sms_nacional_sem_short_number": 164,
        "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.


  • No labels