Un SDK pot simplificar la connexió amb una API de pagaments, però no decideix què ha de passar amb les teves comandes o subscripcions. Tria’l segons el contracte del proveïdor, el llenguatge del projecte i el manteniment que podràs assumir.
Quina feina pot estalviar?
Una llibreria pot ajudar a preparar peticions, signatures, respostes i errors. Revisa exactament què cobreix. Que una funció retorni un objecte de pagament no vol dir que s’hagi actualitzat la venda, enviat el document o activat el servei.
Checklist abans d’afegir la dependència
| Comprovació | Evidència que has de buscar |
|---|---|
| Origen | Proveïdor oficial o projecte de tercers identificat |
| Compatibilitat | Versions de llenguatge, runtime i API |
| Manteniment | Versions recents i tractament d’incidències |
| Contracte | Operacions, paràmetres i errors que exposa |
| Seguretat de la integració | Validació de respostes i tractament de secrets |
| Proves | Exemples reproduïbles a l’entorn de proves |
No presentis una llibreria de tercers com a SDK oficial perquè porti el nom del processador. Guarda la versió que has comprovat; les instruccions d’una altra versió poden no encaixar.
SDK i API directa no són dues lògiques de negoci
Amb SDK, delegues part del codi de connexió a una dependència. Amb API directa, assumeixes més preparació i manteniment. En tots dos casos, l’aplicació necessita relacionar venda, petició i resultat. La mateixa API pot estar darrere de totes dues opcions.
Un recorregut mínim és: l’aplicació determina l’import → crea l’operació → el comprador paga → el servidor valida el resultat → la venda s’actualitza una sola vegada.
Què has de provar?
Comprova una resposta correcta, una resposta no vàlida, un rebuig, un timeout i una notificació repetida. Un timeout deixa un resultat per resoldre; no és una autorització per repetir el cobrament. La matriu de proves explica com separar aquestes situacions.
Si estàs valorant també la pantalla de pagament, consulta checkout allotjat i API. Un checkout allotjat també pot utilitzar una API.
Comença per la documentació d’AndorPay, en castellà, i contrasta les operacions amb la documentació del proveïdor abans d’escriure la integració.