Un checkout allotjat i una integració per API poden formar part de la mateixa solució de pagament. El checkout indica on paga el client; l’API, com es comuniquen l’aplicació i el sistema de cobrament. A AndorPay, el servidor pot crear una sessió per API i enviar el comprador a la pàgina allotjada que retorna la resposta.
Si prepares el cobrament d’una empresa d’Andorra, la decisió útil és quina experiència necessites i quina part del desenvolupament mantindrà el teu equip. Aquesta guia compara la feina de cada recorregut sense donar per fet que utilitzar una API obliga a construir tota la pantalla de pagament.
Tres conceptes per prendre la decisió
Un checkout allotjat és una pàgina preparada i servida per la plataforma de cobrament. El negoci hi envia el comprador amb la compra identificada. Després utilitza la confirmació per continuar la venda.
Una API defineix la comunicació entre sistemes. Permet crear una sessió o consultar recursos, entre altres operacions. La pantalla que veu el comprador i la comunicació del servidor són decisions relacionades, però diferents.
Un plugin adapta la connexió a una plataforma. El nostre plugin WooCommerce relaciona la comanda amb AndorPay i presenta els mètodes disponibles al procés de compra. Pot estalviar feina específica perquè ja coneix les dades i els estats de la botiga.
| Concepte | Pregunta que resol | Exemple amb AndorPay |
|---|---|---|
| Checkout allotjat | On es completa el pagament? | Pàgina oberta des de la sessió creada |
| API | Com connecta l’aplicació? | El servidor crea la sessió i en rep l’adreça |
| Plugin | Com s’adapta a la botiga? | WooCommerce transmet i actualitza la comanda |
Què fa l’aplicació amb un checkout allotjat
Primer identifica la compra i el client. Després demana una sessió amb les dades requerides. La resposta inclou l’adreça que ha d’obrir el comprador. La guia REST d’AndorPay documenta aquest recorregut.
L’aplicació conserva la relació entre compra i sessió. Quan rep el resultat confirmat, aplica l’acció del negoci: preparar una comanda, entregar un recurs o activar l’accés corresponent. La pàgina de pagament resol el seu pas dins d’aquesta venda.
Aquest repartiment permet utilitzar una pantalla preparada sense perdre la connexió amb l’operativa. Continua havent-hi feina al servidor i en la gestió posterior. La diferència és centrar-la en la relació amb el teu producte, en lloc de construir cada component de l’autorització.
Quina feina continua al negoci
El negoci decideix què ven, qui compra, quina informació necessita i què entrega. En una aplicació pròpia, aquestes regles han d’estar representades en dades i processos. La plataforma de cobrament no pot deduir les condicions d’accés només a partir d’una redirecció.
També has de comunicar l’estat al client. Una confirmació clara identifica la compra i el següent pas. Si el pagament està pendent, l’aplicació ha de tractar aquella espera de manera diferent d’un rebuig o d’una venda acabada.
Finalment, algú atendrà incidències. Conserva les referències de comanda i pagament perquè es pugui localitzar una operació. Aquesta necessitat existeix tant amb una pàgina allotjada com amb una experiència integrada a la botiga.
Si ja treballes amb WooCommerce
Comença revisant el plugin abans de plantejar un desenvolupament independent. El nostre recorregut manté productes i càlculs a WooCommerce i utilitza les línies i referències de la comanda. No cal crear un altre catàleg a AndorPay per a aquesta integració.
Revisa els camps, els enviaments i les personalitzacions del checkout. El plugin resol la connexió documentada, però la prova ha d’incloure el que has canviat a la botiga. Si una altra eina rep les vendes per preparar-les, comprova també aquest pas.
La guia de WooCommerce explica la configuració vigent. Utilitzar un plugin permet aprofitar una adaptació existent i verificar-la a la teva instal·lació. Cal mantenir-lo actualitzat i revisar la compra quan es modifiquen extensions que afecten el recorregut.
Si tens una aplicació pròpia
Tria on es crea la compra i quin servidor es comunica amb AndorPay. La clau d’API es conserva en aquest servidor. El navegador rep l’adreça de checkout, no el secret utilitzat per crear-la.
L’aplicació obre l’adreça retornada per l’API. No la construeixis manualment, perquè pertany a una sessió concreta amb dades i caducitat. Utilitzar la resposta documentada evita dependre del format intern de la URL.
Després connecta la confirmació. La guia de webhooks explica com verificar notificacions i relacionar-les amb el sistema. El llenguatge o SDK ajuda a implementar la comunicació; els estats del producte continuen sent part del disseny de l’aplicació.
Com es reparteix el manteniment
Amb una pàgina allotjada, el teu equip manté la creació de sessions, el pas cap al pagament, la recepció d’esdeveniments i l’entrega. La plataforma manté la pantalla corresponent a aquell recorregut. La connexió ha de continuar respectant el contracte utilitzat.
Amb un plugin, una part d’aquesta adaptació ja està implementada per a la botiga. La feina se centra en la configuració, les versions i la convivència amb altres extensions. Les actualitzacions s’acompanyen d’una comprovació de les compres habituals.
Una experiència més personalitzada pot ampliar la superfície que mantindrà el teu equip. Abans d’assumir-la, concreta quina diferència necessita el comprador i si la connexió la permet. Personalitzar elements aporta valor quan resol una necessitat de venda identificada.
Què has de comparar abans de triar
El context que necessita el comprador
Comprova que la persona reconeix el producte, l’import i el comerç. Mantén coherent l’oferta entre la pàgina de venda i el pagament. Un canvi de pantalla s’entén millor quan continua el mateix context.
Revisa també el retorn després de pagar o cancel·lar. El client ha de saber si ha acabat, si ha d’esperar o si pot tornar-ho a provar. Aquesta claredat depèn de la integració i dels missatges, a més del lloc on apareix el formulari.
La feina que pot assumir l’equip
Una aplicació amb servidor i desenvolupament propi pot incorporar sessions i esdeveniments a la seva arquitectura. Una botiga gestionada sense equip tècnic pot necessitar una connexió preparada i ajuda en la configuració.
Decideix qui mantindrà el sistema després del llançament. La resposta permet triar un abast assumible i l’acompanyament necessari. Una demostració ràpida no explica, tota sola, com es resoldrà una incidència mesos després.
Les operacions posteriors al pagament
Defineix com es relacionarà el cobrament amb comandes, subscripcions i entrega. Si necessites renovacions, prepara també el que passa després de la primera compra. Si necessites devolucions, concreta el procediment de la connexió.
La documentació indica que l’adaptador Redsys actual no admet reemborsaments per aquesta API. Escollir una experiència no converteix aquesta operació en automàtica. El procés disponible s’ha de tenir en compte en el conjunt de la venda.
Tres casos per orientar el projecte
Botiga WooCommerce amb catàleg i enviaments. Parteix del plugin i comprova la relació entre comanda, entrega i pagament. La guia d’integració ecommerce desenvolupa el recorregut complet.
Aplicació de serveis digitals. El servidor crea la sessió i la confirmació activa la regla d’accés. El checkout allotjat pot formar part d’aquesta connexió per API. Defineix qui rep el servei i què passa amb els intents pendents.
Servei venut després d’una proposta. Pot ser suficient un enllaç i una entrega gestionada després de pagar. Abans de desenvolupar una connexió pròpia, revisa la guia d’enllaços sense programar. La feina tècnica ha de correspondre a la venda que necessites.
Exemple d’una compra en una aplicació
Imagina un servei digital amb compra puntual. La persona tria el producte i entra al seu compte. El servidor relaciona la compra amb el client, crea la sessió i envia l’adreça de pagament al navegador.
El comprador completa l’autorització. L’aplicació rep el resultat confirmat i activa l’accés d’aquell compte. Si es tanca la pestanya abans de tornar, la comunicació del servidor permet conèixer el resultat i continuar segons les regles preparades.
Després, la mateixa aplicació pot mostrar l’estat de la compra. Si rep una notificació repetida, reconeix l’operació i no entrega dues vegades. En aquest exemple, l’API i la pàgina allotjada es complementen, amb un repartiment clar entre pagament i producte.
Comprova el recorregut abans d’obrir-lo
Fes una autorització correcta, un rebuig i una cancel·lació a l’entorn de proves. Revisa la relació entre compra i pagament i l’estat final de l’aplicació. Afegeix el tancament del navegador i una confirmació posterior al retorn.
Repeteix una notificació per comprovar que no duplica l’efecte de negoci. En una botiga, mira la comanda; en un servei digital, l’accés. La guia de proves d’integració detalla els escenaris i els resultats que convé guardar.
Revisa també el domini, les credencials i els mètodes de l’entorn publicat. Que la connexió funcioni en proves no acredita que producció tingui la mateixa configuració. La posada en marxa inclou les comprovacions acordades per a cada entorn.
Preguntes freqüents
Utilitzar l’API vol dir crear un formulari de targeta?
No. La integració documentada permet crear una sessió i utilitzar-ne la pàgina allotjada. L’aplicació conserva la relació amb la compra i gestiona el resultat confirmat.
Un checkout allotjat elimina qualsevol desenvolupament?
Depèn del recorregut. Una aplicació pròpia ha de crear sessions i gestionar confirmacions. Un enllaç creat al panell pot resoldre una venda manual sense desenvolupar aquest servidor específic.
Puc canviar l’experiència més endavant?
L’evolució ha de conservar comandes, referències i regles de confirmació. Defineix el nou recorregut i comprova com substitueix l’anterior o hi conviu abans d’enviar-hi compradors.
Quina funció té un SDK?
Ajuda a treballar amb una API des d’un entorn concret. No decideix on veurà el comprador la pantalla. La guia d’SDK i integració TPV explica el seu abast.
Defineix l’experiència i el treball de la integració
Explica’ns quina plataforma tens, com compra el client i qui mantindrà la connexió. Prepararem una proposta que concreti l’experiència, la integració i l’acompanyament d’AndorPay.
Consulta el nostre TPV virtual a Andorra i demana una proposta per al teu projecte. Rebràs l’abast i les condicions de manera privada.
