Processar transação
POST
/card/processPayment
O pagamento pode ser processado utilizando um cartão tokenizado ou os dados do cartão enviados diretamente.O campo O campo O campo
O estabelecimento assume a taxa. A taxa será descontada do valor que será liquidado ao estabelecimento.
O cliente assume a taxa. A taxa será adicionada ao valor pago pelo cliente. Quando o cartão já tiver sido tokenizado através da rota Ao utilizar Caso o cartão não tenha sido tokenizado, os dados podem ser enviados diretamente através do objeto Nesse caso, não é necessário informar
💰 Valor
amount representa o valor da transação em reais.Exemplo:
10.00 representa R$ 10,00.📆 Parcelamento
installments define a quantidade de parcelas da transação.1 → Crédito à vista2 ou mais → Crédito parcelado💳 Quem Paga a Taxa
whoPaysFee define quem assume a taxa da transação.merchant
customer
⚠️ Importante: a opção Quando
customer não está disponível para crédito à vista.installments for 1, a taxa será sempre de responsabilidade do merchant.🔐 Cartão Tokenizado
/card/tokenize, utilize o cardId retornado pela tokenização.cardId, não é necessário enviar os dados do cartão novamente.🔒 A tokenização permite reutilizar o cartão através do identificador gerado, sem precisar enviar novamente os dados completos do cartão.
💳 Cartão Não Tokenizado
card.cardId.📌 Regras
- O cartão pode ser informado através de
cardIdoucard. cardIddeve ser utilizado para cartões previamente tokenizados.carddeve ser utilizado quando os dados do cartão forem enviados diretamente.- Não é necessário utilizar
cardIdecardsimultaneamente. installments: 1representa crédito à vista.installments > 1representa crédito parcelado.whoPaysFee: merchantfaz com que a taxa seja descontada da liquidação do estabelecimento.whoPaysFee: customerfaz com que a taxa seja adicionada ao valor pago pelo cliente.customernão pode ser utilizado quandoinstallmentsfor1.
Requisição
Parâmetros Bodyapplication/jsonNecessário
Respostas
Request Request Example
Shell
JavaScript
Java
Swift
curl --location '/card/processPayment' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"amount": 10.00,
"installments": 5,
"whoPaysFee": "merchant",
"cardId": "00000000-0000-0000-0000-000000000000",
"card": {
"holderName": "Nome impresso no cartão",
"expirationDate": "05/31",
"number": "0000000000000000",
"securityCode": "000"
}
}'Response Response Example
{
"success": true,
"message": "Transação processada com sucesso",
"identifier": "000000000"
}Modificado em 2026-09-03 18:17:04