API
Pular para o conteúdo principal

Possibilitar a tokenização do método de pagamento

POST /checkouts

Criação do checkout com os seguintes dados:

Para permitir o armazenamento do método de pagamento é necessário enviar o parâmetro allowRegistration e o uuid do cliente, que pode ser obtido através do consultar cliente

O método de pagamento apenas é armazenado com o consentimento do cliente e após o pagamento ser realizado com sucesso.

Os métodos de pagamento armazenados podem ser consultados através do consultar métodos de pagamento.

Nota: O aramazenamento do método de pagamento apenas esta disponível para os pagamentos com Cartão de Crédito/Débito e MBWay e no layout basic e default.

{
"payment": {
"amount": 500,
"code": "REFPRODUTO_1",
"summary": "Computador",
"customer": {
"uuid": "e2343605-cf46-43de-b20b-9b7d1c95a9b2" // <== Indicar o uuid do cliente
},
"billingAddress": {
"country": "PT",
"city": "Lisboa",
"street1": "Rua Domingos Monteiro nº 7 A",
"postCode": "1050-074"
},
"paymentMethod": {
"code": "CC",
"details": {
"allowRegistration": true // <== Indicar a possibilidade de armazenar o método de pagamento
}
}
},
"page": {
"language": "PT",
"layout": "basic" // <== Indicar o layout que permite armazenar o método de pagamento
}
}

Na resposta é devolvido o id que identifica o checkout perante a API. O checkoutUrl é o link para aceder a página e realizar o pagamento. O paymentId é o id que identifica o pagamento.

Ao aceder ao checkoutUrl é apresentada a seguinte página:

Checkout registration