Dupay

A API de cadastro de Método de Pagamento é utilizada para a geração de token baseados nos dados de cartão de crédito do cliente ou também para a geração de token único de pagamento.

A chamada dessa API deve ser autenticada por meio de token no header da requisição, token este que deve ser gerado utilizando a API de Autenticação.

Todas as requisições à API devem utilizar o método HTTP POST. A API recusa qualquer outro método que não seja o POST nas requisições.

ENVIO DO TOKEN

O token deve ser enviado no header da requisição, no seguinte formato:

“Authorization” : “Bearer seu_token_gerado_aqui”

Exemplo: 

Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJzdWIiOiI5OGYxMzcwODIxMDE5NGM0NzU2ODdiZTYxMDZhM2I4NCIsImVtcHJlc2EiOiI5OGYxMzcwODIxMDE5NGM0NzU2ODdiZTYxMDZhM2I4NCIsImxvZ2luIjoidGVzdGVzQGR1cGF5LmNvbS5iciIsImNsaWVudGUiOm51bGwsImdydXBvIjoiMiIsImV4cCI6MTU2MDE3MTg5MiwiaWF0IjoxNTU5OTk5MDkyfQ.DKycS9HX68c0wDTAoGq2Y3rts-Dqtm_cOugsVKpMq9U

MÉTODO DA API: newPaymentMethod

Parâmetros a serem enviados:

method = “newPaymentMethod”
customerId = ID do cliente que utilizará o cartão.
cardNumber = Número do cartão de credito. 16 dígitos
cvv = Código verificador do cartão. 3 ou 4 dígitos
name = Nome completo impresso no cartão
dueDate = mês e ano de vencimento. Enviar o mês com 2 dígitos e ano com 4 dígitos
remember = Aceita 0 ou 1. Se for zero será gerado um token para uso único.(Apenas uma unica fatura) ou caso seja 1 irá gerar um token como método de pagamento que poderá ser reutilizado por este cliente quantas vezes forem necessárias. Esse parâmetro é muito importante para o momento de geração e pagamento da fatura.

URL DA API

https://painel.dupay.com.br/api_v1/?vkey=5343f84566a14db9f4a8f79c713085c3

Os dados devem ser enviados preferencialmente por JSON e a resposta da API sempre será em JSON.

Exemplo de chamada:

{
    "method": "newPaymentMethod",
    "cardNumber": "4111111111111111",
    "cvv": "123",
    "name": "André Lemos",
    "dueDate": "05/2022",
    "remember": "1",
    "customerId": "2995"
}

Todas as chamadas da API da Dupay respondem em JSON e possui algumas variáveis padrões na resposta. São elas:

status = Retorna 0 para falha e 1 para sucesso na chamada da API
message = Mensagem informativa em caso de falha na chamada da API
data = Dados retornados pela API em caso de sucesso na chamada.

Segue abaixo um exemplo de retorno JSON da chamada de cadastro de cartão de crédito:

{
    "status": 1,
    "message": "Cartão de crédito memorizado com sucesso",
    "data": {
        "paymentToken": "44D088E0B84D47A7A8CE044E7B313558",
        "remember": 1
    }
}