Tokenização do método de pagamento

A tokenização é o processo que permite armazenar os dados de pagamento confidenciais dos clientes de forma segura por meio da criação de um token. Para criar um token devem ser seguidos os seguintes passos:

1. Obter o UUID do cliente;
2. Compra através de checkout usando o id do cliente registado.

1. Obter o UUID do cliente

O primeiro passo é obter o UUID do cliente que pretende registar o seu método de pagamento. Isso pode ser feito através de:

• Criar cliente
• Consultar cliente

2. Concluir pagamento através de checkout

Para o método de pagamento ser disponibilizado é necessário concluir um pagamento com sucesso.

POST /checkouts

Pedido

{
	"payment": {
		"amount": 100,
		"recurring": {
			"amountQualifier": "ESTM" // <== Montante váriável
		},
		"customer": {
			"uuid": "e2343605-cf46-43de-b20b-9b7d1c95a9b2" // <== ID do customer registado
		},
		"paymentMethod": {
			"code": "CC",
			"details": {
				"createRegistration": true // <== Indicar que é para criar token
			}
		}
	},
	"page": {
		"language": "PT"
	}
}

Resposta

{
	"apiVersion": "1.0",
	"date": "2021-10-20T11:34:48+01:00",
	"success": true,
	"data": {
		"id": "Qldt1DlonfiF4HthdiCfB1DRmgM31LzmVrFjU6jk",
		"createdAt": "2021-10-20 11:34:48",
		"checkoutUrl": "http://paypay.acin.pt/paypaybeta/checkout/v2/form/Qldt1DlonfiF4HthdiCfB1DRmgM31LzmVrFjU6jk",
		"paymentId": "42380",
		"stateDetails": {
			"state": "PaymentReady",
			"timestamp": "2021-10-20T11:34:48+01:00"
		}
	}
}

3. Consultar métodos de pagamento do cliente

Após o pagamento com sucesso o método de pagamento é adicionado aos métodos de pagamento do cliente.

GET ​/customers​/{uuid}​/paymentMethods

{
	"apiVersion": "1.0",
	"date": "2021-09-24T17:57:42+01:00",
	"success": true,
	"data": [
		{
			"type": "CC",
			"uuid": "90068f83-7623-4de5-91c7-ac447c504ebf",
			"brand": "VISA",
			"last4Digitis": "0809",
			"holder": "Luís Gonçalves",
			"expireMonth": "05",
			"expireYear": "2026"
		},
		{
			"type": "MW",
			"uuid": "45668f83-7623-4de5-91c7-ac447c504ebf",
			"countryCode": "351",
			"last3Digitis": "263"
		}
	]
}