# Visão Geral

Antes de integrar um produto ou solução Jump Pagamentos, você deve configurar seu ambiente de desenvolvimento para obter <mark style="color:orange;">`client_id`</mark> e <mark style="color:orange;">`client_secret`</mark> 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 <mark style="color:orange;">`client_id`</mark> e <mark style="color:orange;">`client_secret`</mark> 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 <mark style="color:green;">`username`</mark> e <mark style="color:green;">`password`</mark>  ou um parâmetro <mark style="color:green;">`auth`</mark> no qual você passa seu ID de cliente e segredo. Você também pode adicionar seu ID de cliente codificado em <mark style="color:orange;">`Base64`</mark> e segredo em um cabeçalho <mark style="color:green;">`Authorization: Basic`</mark>.

## Como fazer as chamadas da REST API?

* Homologação:  <mark style="color:red;">`https://api-uat.jumppag.com`</mark>
* Produção: <mark style="color:red;">`https://api.jumppag.com`</mark>

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

Esta chamada de exemplo, que mostra a <mark style="color:orange;">`Transaction`</mark> 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.

{% code overflow="wrap" fullWidth="false" %}

```bash
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"
            }
        }
    }'
```

{% endcode %}

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

{% code overflow="wrap" %}

```json
{
    "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"
    }
}
```

{% endcode %}