API
Saltar al contenido principal

Incorporar en aplicación móvil

El checkout se puede incorporar en aplicaciones móviles utilizando el componente "Webview" y el mecanismo "Deep linking" disponible en Android e iOS.

Referencias útiles:

El proceso funciona de la siguiente manera:

  1. (Back-end) Generación del enlace de checkout mediante el recurso /checkouts;
  2. (Aplicación) Abrir el enlace obtenido anteriormente en la webview de Android/iOS;
  3. (Webview) Esperar a que el usuario complete el pago;
  4. (Aplicación) El usuario ha vuelto a la aplicación;
  5. (Back-end) Consultar el estado del checkout a través de la API;
  6. (Aplicación) Presentar la vista de la aplicación de acuerdo;

Generación del enlace de checkout para Webview​

El parámetro redirects del tipo action deberá contener la URL "Deep link" invocará la aplicación tras el pago.

POST /checkouts
{
	"payment": {
		"amount": 500,
		"code": "REFPRODUTO_1",
		"summary": "Computador",
		"customer": {
			"customerId": "1",
			"firstName": "José",
			"lastName": "Silva",
			"phoneNumber": "351#961234567",
			"email": "jose.silva@email.com"
		},
		"billingAddress": {
			"country": "PT",
			"city": "Lisboa",
			"street1": "Rua Domingos Monteiro nº 7 A",
			"postCode": "1050-074"
		},
		"paymentMethod": {
			"code": "CC" // <== Método de pagamento
		}
	},
	"page": {
		"language": "PT",
		"layout": "default" // <== Incorporado
	},
	"redirects": [
		{
			"type": "action",
			"url": "https://www.myapp.com" // <== URL deep Link
		}
	]
}