Gerando pedidos e pagamentos

Neste guia você vai aprender a cadastrar um aplicativo representando sua empresa ou plataforma para solicitar acesso à conta de outros estabelecimentos. Com isso você pode realizar cobranças via API ou pela nossa interface.

Gerando suas credenciais

Para recuperar suas credenciais de API entre na plataforma web, acesse sua conta em ambiente de sandbox, vá no menu lateral esquerdo, clique em Configurações -> Desenvolvedor -> Chaves de Acesso.

O ID do vendedor é o ID da sua conta utilizado nas URLs da API.

O refresh token você utiliza para atualizar sua chave de acesso quando ela expirar. O período de validade da chave é de 1 semana.

A chave de cliente é utilizada na URL para tokenizar cartões.

Para gerar uma chave de acesso, realize uma chamada POST na url de Autenticação Referência da API (getpostman.com):

curl -X POST 'https://api-dev.genpag.com.br/api/:sellerId/tokens' \

        -H 'Content-Type: application/json' \

        -H 'Authorization: Bearer <refresh_token>'

Passando o id do vendedor na url e utilizando o refresh token no cabeçalho Authorization.

A chave de acesso gerada no passo anterior tem a validade de 1 semana. Depois disso, você precisa gerar uma nova.

Gerando um pedido com a chave obtida

Depois de gerar as chaves de acesso, você pode começar a criar pedidos e pagamentos.

Quando o pedido for pago, seja pela nossa página de checkout ou pela sua interface, você receberá na sua conta bancária cadastrada os valores referentes à sua venda.

Para cadastrar um pedido, envie requisição POST conforme os parâmetros abaixo para o endpoint /api/sellers/:sellerId/orders:

Referência da API: Criar Pedido

curl -X POST 'https://api-dev.genpag.com.br/api/sellers/:sellerId/orders' \

--header 'Authorization: Bearer <access_token>'

--header 'Content-Type: application/json' \

--data-raw '{

    "order": {

        "items": [

            {

                "description": "tempor anim",

                "quantity": 1,

                "unit_price_cents": 4498,

            },

            {

                "description": "veniam co",

                "quantity": 1,

                "unit_price_cents": 5000,

            }

        ]

    }

}'

O parâmetro :sellerId da URL é o ID do seu estabelecimento.

Se a requisição acima resultar em sucesso, você receberá como resposta um objeto contendo os dados do pedido:

{

   "data": {

        "id": "6d4476d7-542a-543b-81ca-966618b9f48a",

        "seller_id": "72e0e63b-1323-17a4-e8a3-6df8ae93f352",

        "marketplace_id": "d411aaf0-329a-6f29-8443-ba0422223b67",

        "items": [

            {

                "description": "tempor anim",

                "quantity": 1,

                "unit_price_cents": 4498,

            },

            {

                "description": "veniam co",

                "quantity": 1,

                "unit_price_cents": 5000,

            }

        ],

        "fee_percent": 10.0,

        "customer_id": null,

        "subtotal_cents": 9498,

        "discount_cents": 0,

        "addition_cents": 0,

        "shipping_cents": 0,

        "total_cents": 9498,

        "status": "PENDING",

        "external_id": null,

        "location": { },

        "customer_data": { },

        "shipping_address": { },

        "subscription_id": null,

        "inserted_at": "1966-05-05T00:33:17.927Z",

        "updated_at": "2009-04-07T12:26:30.452Z"

   }

}

Agora é só utilizar o :id do pedido para gerar o link da página de checkout, ou passar como um parâmetro na criação do pagamento, caso esteja fazendo sua própria interface de checkout.

Página de Checkout

Após criar o pedido, redirecione o usuário final para a página de checkout seguindo o padrão de URL a seguir:

// Ambiente de homologação

// https://app-dev.genpag.com.br/orders/:id?redirectTo=<sua_url>

"https://app-dev.genpag.com.br/orders/6d4476d7-542a-543b-81ca-966618b9f48a?redirectTo=https://example.com"

// Ambiente de produção

// https://app.genpag.com.br/orders/:id?redirectTo=<sua_url>

"https://app.genpag.com.br/orders/6d4476d7-542a-543b-81ca-966618b9f48a?redirectTo=https://example.com"

No campo :id utilize o id do pedido gerado anteriormente e o usuário final irá acessar a interface de checkout.

Se o cliente abrir a url em um dispositivo mobile, ele será redirecionado para nosso checkout smartPOS responsivo.