Permitir la tokenización del método de pago.

POST /checkouts

Creación del checkout con los siguientes datos:

• Idioma: Portugués
• Diseño de página: básico
• Importe: 5€
• Método de pago: Multibanco (MB)
• Posibilidad de guardar el método de pago
• Código del producto: REFPRODUCT_1
• Descripción del producto: Ordenador
• Redirecciones:
  • Después de un pago con éxito: https://www.url-apos-sucesso.dominio
  • Después de la cancelación del pago: https://www.url-apos-cancelamento.dominio
  • Botón regresar: https://www.url-voltar.dominio

Para permitir el almacenamiento del método de pago es necesario enviar el parámetro allowRegistration y el uuid del cliente, que puede obtenerse a través de consult customer

El método de pago únicamente es almacenado con el consentimiento del cliente y después de que el pago haya sido completado con éxito.

Los métodos de pago almacenados pueden verse a través de consultar métodos de pago.

Nota: La configuración del método de pago únicamente está disponible para los pagos con Tarjeta de Crédito/Débito y MBWay y en el diseño basic y default.

Solicitud

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

Respuesta

{
	"apiVersion": "1.0",
	"date": "2022-01-03T14:16:17+00:00",
	"success": true,
	"data": {
		"id": "pyKP1B9IaK9J47wTSNB4mUnv2h4DJW8HzomddMp1",
		"createdAt": "2022-01-03 14:16:17",
		"checkoutUrl": "https://paypay.pt/paypay/referencia/referencia_c/pay/4d0757e6d4db52fae248e1a2e9f10a1e8cdb0a25/paypay/pyKP1B9IaK9J47wTSNB4mUnv2h4DJW8HzomddMp1",
		"paymentId": "42690",
		"stateDetails": {
			"state": "PaymentReady",
			"timestamp": "2022-01-03T14:16:17+00:00"
		}
	}
}

La respuesta devuelve el id que identifica el checkout ante la API. El checkoutUrl es el enlace para acceder a la página y realizar el pago. El paymentId es el id que identifica el pago.

Al acceder a checkoutUrl aparece la siguiente página: