Tokenización del método de pago

La tokenización es el proceso por el cual los datos confidenciales de pago de los clientes se almacenan de forma segura mediante la creación de un token. Para crear un token, hay que seguir los siguientes pasos:

1. Obtener el UUID del cliente;
2. Compra a través de checkout usando el id del cliente registrado.

1. Obtener el UUID del cliente

El primer paso es obtener el UUID del cliente que desea registrar su método de pago. Esto puede hacerse a través de:

• Crear cliente
• Consultar cliente

2. Concluir el pago a través de checkout

Para que el método de pago esté disponible es necesario concluir un pago con éxito.

POST /checkouts

Solicitud

{
	"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"
	}
}

Respuesta

{
	"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 pago del cliente

Una vez realizado el pago con éxito, el método de pago es añadido a los métodos de pago del 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"
		}
	]
}