- Credencials d’API
- Compte de comerç
- Clau d’API
- Prefix de l’URL de l’API
- Clau HMAC
Connectareu el vostre compte de comerç d’Adyen a TourTask: quatre valors, un webhook i un pagament de prova. Necessiteu un compte d’Adyen en producció, no un de proves, i aconseguir-lo porta setmanes.
Aconseguiu un compte d’Adyen en producció
- 1
Contacteu amb l’equip comercial d’Adyen
Feu servir el formulari comercial d’Adyen i digueu que veneu tours. Adyen considera els operadors turístics un sector restringit, amb documents addicionals i una revisió més llarga.
- 2
Pregunteu pel dipòsit de garantia abans de signar
Adyen pot retenir una part de les vostres liquidacions com a dipòsit de garantia. Per a tours pagats amb mesos d’antelació, pot ser elevat.
Copieu les vostres dades d’Adyen
Inicieu la sessió a la Customer Area de producció, ca-live.adyen.com, amb un usuari que tingui el rol Merchant admin. Tingueu cada valor a mà: els ompliu tots quan afegiu Adyen a TourTask, després del webhook.
- 1
Copieu el compte de comerç
A Settings → Merchant accounts, copieu el codi del compte de comerç, no el del compte d’empresa. Va a Compte de comerç a TourTask.
- 2
Copieu el prefix de l’URL
A Developers → API URLs, copieu el Prefix: només el prefix, no una adreça web sencera. Va a Prefix de l’URL de l’API a TourTask.
- 3
Creeu una credencial d’API
Seleccioneu el vostre compte d’empresa, aneu a Developers → API credentials i obriu la pestanya Payments. Seleccioneu Create new credential, trieu Web service user i, després, Create credential.
- 4
Genereu la clau d’API
A Server settings → Authentication, obriu la pestanya API key i seleccioneu Generate API key. Adyen només mostra la clau una vegada: copieu-la per a Clau d’API a TourTask i, després, seleccioneu Save changes a Adyen.
Creeu el webhook
Sense aquest webhook, als viatgers se’ls cobra, però les seves reserves queden sense confirmar.
La vostra adreça de webhook de TourTask per a Adyen
https://api.tourtask.com/v1/payments/adyen/notifications/booking- 1
Afegiu un webhook estàndard
A la Customer Area de producció, aneu a Developers → Webhooks, seleccioneu Create new webhook i, després, Add al costat de Standard webhook.
- 2
Activeu-lo per al vostre compte de comerç
A General, activeu Enabled i comproveu que Merchant accounts inclogui el vostre.
- 3
Introduïu l’adreça de TourTask
A Server configuration, enganxeu l’adreça de TourTask de més amunt com a URL.
- 4
Genereu la clau HMAC
A Security, seleccioneu la icona d’edició al costat d’HMAC Key i, després, Generate. Adyen només mostra la clau una vegada: copieu-la per a Clau HMAC a TourTask.
- 5
Seleccioneu Save configuration
Després, ometeu Test configuration: falla fins i tot quan el webhook és correcte.
Afegiu Adyen a TourTask
- 1
Obriu la targeta de Adyen
Aneu a Configuració → Opcions de pagament i feu clic a la targeta Adyen a Pagaments en línia → Passarel·les de pagament. No hi és? Trieu Mostra totes les passarel·les de pagament sota les targetes.
- 2
Trieu el país i la moneda
A País, trieu el país del vostre compte de Adyen i del seu compte bancari, i a Moneda, la moneda en què paguen els viatgers. Feu clic a Afegeix. Per canviar-ne qualsevol més endavant, traieu Adyen amb Treu i torneu-lo a afegir.
- 3
Ompliu les vostres credencials d’API
A Autenticació, la targeta té un camp per a cadascuna:
Compte de comerç
Clau d’API
Prefix de l’URL de l’API
Clau HMACCada camp es desa quan feu clic fora.
- 4
Activeu Adyen
Feu clic a Activa quan tots els camps estiguin emplenats. La targeta passa a Actiu i els viatgers poden pagar amb Adyen a la vostra pàgina de reserves. Cada pagament arriba directament al vostre propi compte de Adyen: TourTask mai no reté els vostres diners.
Proveu Adyen
TourTask no té mode de proves per a Adyen, així que feu la prova amb una reserva real petita que després reemborseu.
- 1
Pagueu una reserva
Reserveu el vostre tour més barat a la vostra pròpia pàgina de reserva, trieu Adyen i pagueu amb la vostra pròpia targeta. Quan torneu a la pàgina de reserva, la reserva es confirma tota sola.
- 2
Reemborseu el pagament
A la reserva, trieu Reemborsa el pagament al menú d’accions del pagament i, després, Reemborsa amb Adyen.
- 3
Cancel·leu la reserva de prova
Si el pagament de prova falla
- El pagament falla de seguida: comproveu que els quatre valors provenen de la Customer Area de producció. Compte de comerç ha de ser el codi del compte de comerç, no el del compte d’empresa.
- Heu pagat, però la reserva no es confirma: a la Customer Area de producció, comproveu que el webhook està Enabled, que inclou el vostre compte de comerç i que té l’URL exactament com a dalt. Si és així, genereu-hi una nova HMAC Key i enganxeu-la a Clau HMAC a TourTask. Després, seleccioneu Save configuration a Adyen.
Preguntes freqüents
Els que estan activats per al vostre compte de comerç a la Customer Area d’Adyen. TourTask no els filtra.
Normalment uns quants dies. TourTask registra el reemborsament a l’instant, i la vostra Customer Area d’Adyen mostra quan s’han retornat els diners.
No. TourTask envia els viatgers a la pàgina de pagament pròpia d’Adyen, així que no cal configurar res per a això.