Visão Geral

Antes de integrar um produto ou solução Jump Pagamentos, você deve configurar seu ambiente de desenvolvimento para obter client_id e client_secret do OAuth 2.0 para os ambientes de homologação e produção. Você trocará essas credenciais por um token de acesso que autoriza suas chamadas de API REST. Para testar seus aplicativos da web e aplicativos, é necessário criar uma conta na homologação. Entre na Plataforma Jump Pagamentos para obter credenciais e criar a conta em homologação requer uma conta de desenvolvedor, suporte ou administrador. Cada conta fornece diferentes níveis de acesso à funcionalidade da API.

Como conseguir as credenciais?

Para gerar as Credenciais da API tanto para Homologação como para Produção:

1. Entrar na Plataforma da Jump Pagamentos com sua conta

2. No menu Administração, selecione Credenciais

3. Lembre-se de anotar o client_secret escolhido, uma vez salvo, não há como recuperá-lo, você precisará criar um novo.

Como conseguir o TOKEN de acesso?

Seu token de acesso autoriza você a usar o servidor JUMP REST API. Para chamar uma REST API em sua integração, troque seu client_id e client_secret por um token de acesso em uma chamada de token OAuth 2.0. Embora existam algumas maneiras de obter um token, aqui estão exemplos usando o aplicativo Postman e um comando cURL.

A biblioteca ou função HTTP do seu próprio ambiente pode ter campos username e password ou um parâmetro auth no qual você passa seu ID de cliente e segredo. Você também pode adicionar seu ID de cliente codificado em Base64 e segredo em um cabeçalho Authorization: Basic.

Como fazer as chamadas da REST API?

• Homologação: https://api-uat.jumppag.com

• Produção: https://api.jumppag.com

Além disso, inclua seu token de acesso para provar sua identidade e acessar recursos protegidos.

Esta chamada de exemplo, que mostra a Transaction cria, inclui um token portador no cabeçalho da solicitação Authorization. Este tipo de token permite que você conclua uma ação em nome de um proprietário de recurso.

curl -v --location --request POST 'https://api-uat.jumppag.com/transaction/checkout' \
    --header 'Content-Type: application/json' \
    --header 'Authorization: Bearer <Access-Token>' \
    --data-raw '{
        "customer_id": "58f0c005-3b7d-4d75-81g3-93b9a6fff864",
        "branch": "Escritório 1",
        "name": "José da Silva",
        "amount": 43,
        "currency": "BRL",
        "callback": "http://mysite.com/api/notification",
        "transaction": {
            "id": "b08e3897-6404-4ba4-81a5-6e3a1d29e277",
            "redirect": {
                "url": "http://mysite.com/success_payment",
                "type": "URL"
            }
        }
    }'

A resposta mostra a página ou URL, escolhida pelo tipo de redirecionamento:

{
    "requestId": "73eaaecf-1bf4-4847-b4a9-8c615e891e1b",
    "data": {
        "url": "https://api-uat.jumppag.com/checkout/v1/f834fc1b-c8a0-4613-bcc9-2c188f6ef180",
        "transaction_id": "f834fc1b-c8a0-4613-bcc9-2c188f6ef180"
    }
}