Seu primeiro pagamento em sandbox

Cinco passos, na ordem em que a API espera. Tudo aqui roda contra o ambiente de sandbox, com cartão de teste, e cada passo existe como requisição na coleção.

1. Pegue as credenciais e a coleção

   No Backoffice da Vellus, abra Integrações e gere um clientId e um clientSecret de sandbox (Credenciais). Importe no Postman a coleção e o ambiente, e preencha as duas variáveis.

   Coleção Postman · Vellus Payments · Pagamentos e checkoutspec v2

   A coleção desta versão da spec ainda não foi publicada. Ela sai do pipeline do serviço, gerada da mesma spec e testada contra a sandbox antes de aparecer aqui. Enquanto isso, use a referência da API.

2. Gere um token de acesso

   Peça um token em POST /connect/token com as credenciais. O token vai no cabeçalho Authorization: Bearer das próximas chamadas (Autenticação).

3. Tokenize um cartão de teste

   Chame POST /v2/tokenization com o cartão de teste 4111 1111 1111 1111. Guarde o token devolvido; o número do cartão não volta mais.

4. Crie o pagamento

   Chame POST /v2/payment usando o token do cartão no lugar dos dados dele.

   curl -X POST https://api-payments.sand-fintech.com/v2/payment \
     -H "Authorization: Bearer $TOKEN" \
     -H "Content-Type: application/json" \
     -d @pagamento.json

5. Confira a transação

   Consulte GET /v2/payment/transaction/{transactionId} e veja o status. Se algo falhar, o corpo traz o code e o link para a página do erro no campo type.