# 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 %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.jumppag.com/visao-geral.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.