Andorpay
Torna al blog

Publicat el · Actualitzat el

Passarel·la de pagament a Andorra per a la teva botiga

Connecta pagaments i comandes a la teva botiga d’Andorra. Guia de WooCommerce, checkout, estats, incidències i posada en marxa amb AndorPay.

Cistella de compra en un portàtil connectada amb dos paquets i una targeta de pagament.

Una passarel·la de pagament per a una botiga d’Andorra ha de connectar la compra amb el cobrament i retornar un resultat que permeti gestionar la comanda. El comprador necessita pagar sense perdre el context; el teu equip necessita saber si pot preparar l’entrega. Aquest és el recorregut que cal integrar, encara que el botó de targeta sigui la part més visible.

A AndorPay connectem el pagament amb la infraestructura bancària i amb la botiga o aplicació del negoci. Aquesta guia desenvolupa la integració ecommerce: plataforma, checkout, dades, estats, incidències i posada en marxa. Si encara estàs definint com vendràs, comença per la guia general per cobrar online des d’Andorra.

Què ha de resoldre la passarel·la a la botiga

La passarel·la participa en l’autorització del pagament i comunica el resultat. La integració relaciona aquest resultat amb la compra. Quan les dues parts estan preparades, un cobrament confirmat correspon a una comanda concreta i el client rep una explicació coherent.

La botiga manté altres responsabilitats: calcular la compra, recollir les dades necessàries, gestionar existències i entregar. Un pagament correcte no completa una adreça ni decideix quin producte s’ha d’enviar. Per això, la comprovació ha de començar al carret i acabar en la gestió de la comanda.

Un botó que no apareix, una comanda pendent després de pagar i un correu que no arriba són problemes diferents. Separar-los ajuda a intervenir en el punt adequat i evita modificar tota la botiga per resoldre una incidència situada en una sola connexió.

Les peces que participen en una venda

El comprador veu un únic procés, però la botiga, la connexió de pagament i la infraestructura bancària treballen coordinades. El teu sistema de gestió pot afegir un altre pas per preparar l’enviament o activar un servei.

Peça Funció Informació que s’ha de conservar
Botiga o aplicació Prepara la compra Comanda, línies, import i client
Checkout Presenta el pagament Sessió vinculada a la compra
Processament Obté l’autorització Operació i resultat confirmat
Integració Actualitza la venda Relació entre comanda i pagament
Entrega o accés Compleix el que s’ha comprat Estat de l’enviament o servei

No has de gestionar totes les peces manualment. Sí que necessites una relació clara entre elles perquè l’equip pugui trobar una venda sense reconstruir-la a partir de converses, captures i imports semblants.

Revisa breument el que ja tens

Identifica la plataforma, el tipus de checkout i les personalitzacions que afecten les comandes. Inclou els impostos configurats a la botiga, els enviaments, els cupons, les variants i les eines que reben les vendes després del cobrament.

Tria una compra representativa i segueix-la de principi a fi. Anota on es calcula el total, quan es recull l’adreça i quina pantalla utilitza l’equip per preparar l’entrega. Aquesta revisió defineix què s’ha de conservar quan es connecta el pagament.

Si ja cobres amb una altra connexió, afegeix què funciona i què vols millorar. Pot faltar un mètode, haver-hi massa feina manual o fallar l’actualització de comandes. Una necessitat concreta permet limitar el canvi i comprovar després si ha resolt el problema.

El punt de partida depèn de la plataforma

WooCommerce

El nostre plugin connecta WooCommerce amb AndorPay. Els productes i els càlculs es mantenen a la botiga; el plugin transmet les línies i referències necessàries. Per a aquesta integració no has de crear un segon catàleg a AndorPay.

La documentació cobreix el checkout clàssic, Checkout Blocks, HPOS i el pagament d’una comanda existent. Abans d’instal·lar o actualitzar, identifica les versions de WooCommerce i del plugin i les extensions que modifiquen el checkout. La guia de WooCommerce recull la configuració vigent.

Shopify i plataformes amb checkout controlat

La plataforma estableix quines connexions admet i com es presenta el pagament. Que un proveïdor sigui compatible amb una eina no implica que qualsevol mètode o model recurrent es pugui utilitzar dins d’aquella integració.

Si fas servir Shopify, revisem el recorregut disponible i la manera com vens abans de proposar canvis. Si la plataforma no cobreix el cas, valorem què comportaria una alternativa: productes, comandes, entrega i feina del teu equip. La decisió ha de respondre a l’activitat real.

Una aplicació pròpia

El servidor prepara la compra i crea una sessió amb l’API. El comprador obre l’adreça de pagament rebuda i l’aplicació processa els esdeveniments que comuniquen el resultat. La guia REST explica aquesta connexió.

Defineix com relacionaràs client, producte, comanda i operació des del començament. L’API connecta els sistemes, però les regles d’entrega i accés continuen a la teva aplicació. Aquesta separació ajuda a mantenir el recorregut quan canvies el catàleg o les pantalles.

Checkout allotjat i pagament dins de la botiga

Un checkout allotjat utilitza una pàgina preparada per la plataforma de cobrament. La teva aplicació crea la sessió i envia el comprador a l’adreça corresponent. Després rep la confirmació necessària per continuar la venda.

A WooCommerce, el plugin connecta la compra habitual amb els mètodes disponibles. El client conserva el context de la comanda mentre paga. La decisió sobre l’experiència depèn de la plataforma, el manteniment que pots assumir i la informació que cal recollir.

L’API i el checkout allotjat poden formar part de la mateixa integració. La primera explica com es comuniquen els sistemes; el segon, on paga la persona. La guia de checkout allotjat i API desenvolupa aquesta distinció i el treball que assumeix cada part.

Prepara el TPV per al que vols oferir

La connexió bancària ha de correspondre al recorregut de venda. Indica si necessites compres puntuals, wallets o recurrència. Cada modalitat té preparatius propis; disposar d’un TPV virtual no acredita que totes estiguin activades.

Amb el nostre plugin WooCommerce, la targeta requereix Redsys inSite. Apple Pay i Google Pay necessiten X-PAY i la configuració del banc i de cada wallet. Activem els mètodes disponibles per al comerç, que es presenten segons l’entorn compatible del comprador.

Per començar, explica’ns el banc, la situació del TPV i la plataforma. Amb aquesta informació concretem la preparació i l’abast. La guia de bancs i TPV a Andorra ajuda a ordenar la conversa amb la teva entitat.

Conserva la relació entre carret i pagament

L’import autoritzat ha de correspondre a la compra preparada pel sistema. Inclou productes, variants, descomptes i entrega calculats per a aquella comanda. Si alguna dada canvia abans de pagar, el recorregut ha d’aplicar l’actualització de manera coherent.

Per exemple, canviar el país d’enviament pot modificar les opcions disponibles. El comprador ha de revisar el total correcte abans d’autoritzar. Utilitzar un import anterior genera una diferència que després s’haurà de resoldre amb feina manual.

Mantén una referència comuna entre comanda i operació. Quan hi ha un rebuig o una cancel·lació, identifica també quin intent pertany a cada compra. Així pots recuperar la venda sense confondre un primer intent fallit amb el resultat d’un segon.

Les dades d’entrega formen part de la integració

Per als productes físics, defineix els camps que fan falta per enviar-los. Comprova adreça, contacte i opció d’entrega a la comanda final. En un producte digital, identifica el correu o compte que rebrà el recurs.

Les wallets poden simplificar la introducció de dades, però no pressuposis que aportaran tots els camps en qualsevol situació. El recorregut ha de recollir la informació que falta. Inclou a les proves els camps personalitzats i les regles que depenen de l’adreça.

La comprovació acaba amb una venda que es pot entregar. Si l’equip ha de contactar després per demanar una dada obligatòria, identifica on s’ha perdut. El pagament pot ser correcte mentre una altra part de la compra necessita un ajust.

Què ha de passar durant l’autorització

El comprador selecciona el mètode i completa l’acció demanada. Pot aparèixer una autenticació addicional o un període d’espera. La pantalla ha de mantenir el context i explicar la situació sense convidar a repetir la compra abans de saber-ne el resultat.

Un rebuig necessita una sortida comprensible. Una cancel·lació voluntària ha de permetre tornar al recorregut. Una resposta pendent necessita un tractament propi perquè encara no és un resultat definitiu.

La documentació del cicle de pagament descriu els estats d’AndorPay. L’equip d’integració els utilitza per decidir quan es pot fer un altre intent i quan s’ha de continuar consultant l’operació existent.

Tornar a la botiga i confirmar el pagament són passos diferents

La pàgina d’agraïment orienta el client, però no substitueix el resultat confirmat al servidor. El navegador es pot tancar abans de tornar, i la notificació pot arribar després. La integració ha de preveure aquestes dues situacions.

Els esdeveniments d’AndorPay comuniquen el resultat a l’aplicació. El teu sistema verifica la notificació i aplica l’actualització corresponent. La guia de webhooks explica la connexió i la comprovació de la signatura.

Si la mateixa notificació arriba una altra vegada, no ha de provocar una segona entrega. L’aplicació reconeix l’operació ja processada. Per comprovar aquest comportament es pot repetir l’esdeveniment de prova sense crear un altre cobrament.

Relaciona l’estat de pagament amb el de comanda

L’equip treballa amb estats comercials: pendent, a punt per preparar, enviada o completada. Aquests estats han de seguir regles relacionades amb el cobrament, però també amb el producte i amb l’entrega.

Resultat del pagament Què necessita fer la botiga
Confirmat Relacionar-lo amb la comanda i aplicar la regla de preparació
Pendent Conservar la referència i esperar o consultar el resultat
Acció requerida Permetre que el client completi el pas necessari
Fallit Mantenir la comanda sense pagar i oferir recuperació

No marquis una comanda com a entregada només perquè s’ha cobrat. Tampoc demanis un altre pagament perquè la pantalla de preparació no s’hagi actualitzat. Identifica primer quina etapa ha acabat i quina falta sincronitzar.

Configuració pràctica a WooCommerce

Instal·la la versió del plugin que correspongui i obre la configuració als ajustos de pagament. La guia indica les adreces d’API i checkout, la clau de proves i l’activació dels mètodes disponibles. Segueix la seqüència per mantenir els components al mateix entorn.

Quan deses la connexió, el plugin prepara la identitat i el registre de notificacions. La ruta de comunicació ha de ser accessible i les tasques programades s’han de poder executar. Si el tallafoc bloqueja una petició, revisa l’accés concret que necessita aquesta integració.

La documentació descriu com consultar les accions programades i sincronitzar una comanda amb AndorPay. Aquestes eines permeten recuperar la coherència amb una operació existent. Completar una comanda manualment o repetir el cobrament sense consultar-lo pot amagar el problema original.

Prepara una resposta clara a les incidències

Si el client diu que ha pagat però la web continua esperant, busca primer la comanda i l’operació. Comprova el resultat confirmat abans de decidir si cal un altre intent. La prioritat és explicar què ha passat amb aquella compra.

Si el pagament està confirmat i falta actualitzar la comanda, revisa la comunicació entre sistemes. Si la comanda està correcta però falta el correu, el problema és la notificació al comprador. Separar aquests casos evita canviar innecessàriament el procés d’autorització.

Guarda les referències, el moment i el resultat observat. No cal demanar el número complet de la targeta. L’equip necessita informació que permeti trobar el recorregut i explicar l’estat actual i el següent pas a la persona.

Devolucions i cancel·lacions necessiten un procediment

Cancel·lar una compra abans de pagar, anul·lar un servei i retornar un cobrament són accions diferents. Defineix què pot demanar el client i què farà l’equip en cada situació. La botiga ha de reflectir el que s’ha executat realment.

La documentació indica que l’adaptador Redsys actual no admet reemborsaments per aquesta API. Per això, el procés de devolució es concreta per a la connexió del comerç abans d’oferir-ne l’automatització. Una petició interna no s’ha de mostrar com si els diners ja s’haguessin retornat.

Relaciona la gestió amb la comanda i el pagament originals. Això permet respondre consultes i distingir una devolució demanada d’una d’executada. Les condicions comercials i l’acció de pagament s’han de mantenir coherents durant el seguiment.

Si la botiga ven subscripcions

La recurrència afegeix el cicle posterior a la primera compra. Has de definir període, renovació, canvis i baixa, juntament amb l’accés o l’entrega associats. Una primera autorització correcta no acredita que tot aquest cicle estigui preparat.

A AndorPay, cal la capacitat de subscripcions i una connexió apta. L’aplicació utilitza els esdeveniments i les operacions disponibles segons les seves regles de servei. La guia de recurrència amb Redsys desenvolupa els requisits específics.

Si trasllades subscripcions, aclareix què passarà amb els mitjans guardats i amb el següent cobrament. No pressuposis portabilitat ni deixis dos sistemes programant el mateix període. La transició ha d’assignar qui gestiona cada relació i des de quina data.

Dissenya proves que representin les teves vendes

Tria comandes habituals: un producte amb enviament, una variant, un descompte si en fas servir i un recurs digital si forma part del catàleg. Comprova el total abans de pagar i les dades finals després. No cal inventar combinacions que la botiga no ofereix.

Afegeix èxit, rebuig, cancel·lació i tancament del navegador. Inclou una notificació repetida i una confirmació tardana. Per a cada cas, decideix abans què ha de veure el comprador i quin estat necessita l’equip. La prova compara així un resultat amb una expectativa clara.

Escenari Què s’ha de comprovar
Compra habitual Coincideixen comanda, import i confirmació
Canvi d’entrega S’utilitza el total revisat pel comprador
Cancel·lació La compra manté un estat comprensible
Resposta tardana La botiga recupera el resultat existent
Esdeveniment repetit No duplica entrega ni accés
Wallet compatible Autoritza i conserva les dades necessàries

La guia de proves detalla entorns i escenaris. Guarda les referències dels casos per poder investigar una incidència sense demanar una altra operació al client.

Inclou la persona que prepara les comandes

Demana-li que revisi una comanda de prova des de la pantalla que fa servir cada dia. Ha de poder identificar el producte, l’entrega i el resultat del pagament. La informació útil per al desenvolupador no sempre coincideix amb la que necessita aquesta persona.

En un producte digital, fes la mateixa comprovació amb qui gestiona l’accés. Si un estat és ambigu, defineix el missatge o la regla abans de publicar. Aquest petit pas evita que una integració correcta tècnicament continuï requerint preguntes per atendre cada venda.

Publica amb la configuració de l’entorn real

Abans d’obrir el recorregut, comprova el domini, les credencials i els mètodes de producció. Si has treballat amb una adreça provisional, revisa què canvia en passar a la definitiva. Mantén identificable quina versió i quina integració estan actives.

Decideix què farà l’equip si apareix un problema en obrir. Pot caldre aturar noves peticions del mètode afectat mentre es revisen les operacions pendents, conservant la informació existent. La resposta ha d’evitar dos intents sense que el comprador sàpiga quin correspon a la seva compra.

La posada en marxa acaba quan s’ha comprovat el recorregut publicat i la seva gestió segons el pla previst. Pujar fitxers, desar una configuració o veure un botó són passos intermedis d’aquesta feina.

Observa les vendes i la feina de l’equip

Revisa pagaments confirmats, comandes pendents i consultes dels clients per dispositiu i mètode. Si canvies de campanya alhora, tingues-ho en compte: l’origen del trànsit pot influir en el comportament de compra.

Mira també quanta feina necessita una venda per quedar preparada. El checkout pot autoritzar bé i, tot i així, generar dubtes d’entrega o confirmació. Aquestes consultes ajuden a trobar el següent ajust útil.

Fes servir les referències compartides per examinar casos concrets. La millora s’ha de veure en una compra clara i una comanda gestionable, a més de l’aspecte de la pantalla. Aquesta base permet ampliar mètodes o automatitzacions quan el negoci ho necessiti.

Preguntes freqüents

He de canviar de botiga per utilitzar AndorPay?

Revisem la plataforma i el recorregut actual abans de plantejar canvis. WooCommerce té una integració documentada. En altres plataformes cal estudiar les possibilitats i l’abast necessari per a la teva venda.

Puc conservar el catàleg de WooCommerce?

Sí. El plugin utilitza les línies i referències calculades per la botiga. No cal duplicar aquest catàleg a AndorPay per a la connexió documentada.

Què passa si el client tanca la pàgina després de pagar?

El resultat s’ha de recuperar a través de la comunicació del servidor i relacionar-se amb la comanda. El retorn del navegador no és l’única via de confirmació.

Quan convé afegir més mètodes?

Quan aporten una opció útil als compradors i la connexió està preparada. Comprova el recorregut complet, incloses les dades d’entrega i l’estat de comanda, per a cada mètode.

Connecta el pagament amb tota la teva botiga

Explica’ns quina plataforma utilitzes, amb quin banc treballes i què vols millorar. Revisarem la compra completa per presentar-te una proposta concreta d’integració amb AndorPay.

Consulta el nostre TPV virtual a Andorra i demana una revisió de la teva botiga. Et presentarem l’abast i les condicions de manera privada.

WhatsApp