Un link de plată este o metodă securizată de a primi plăți printr-un link simplu de plată de tip URL. Acesta vă oferă un mod suplimentar de a accepta o plată, care implică generarea unui link URL de plată și partajarea acestuia cu plătitorul prin diferite canale de comunicare, cum ar fi e-mailul, mesajele text sau un cod QR. Când un plătitor face clic pe linkul URL de plată, acesta este redirecționat la pagina de plată, unde poate selecta metoda de plată pentru a finaliza tranzacția.
Principalele avantaje ale unui link de plată sunt:
Când plătitorii primesc un link URL unic de plată în vederea efectuării unei plăți, aceștia pot face clic pe link pentru a efectua plata.
Această diagramă prezintă etapele de efectuare a unei tranzacții cu ajutorul unui link de plată.
Înainte de inițierea unei operațiuni de validare, asigurați-vă că sunt setate următoarele atribute pentru linkurile de plată:
Dacă este specificat și apare o eroare, gateway-ul va furniza codul de eroare (errorCode
) și descrierea acesteia (errorDescription
) ca parametri ai șirului de interogare. Gateway-ul va păstra, de asemenea, orice parametri ai șirului de interogare pe care i-ați inclus în errorUrl.
De exemplu, dacă specificați paymentLink.errorUrl ca https://merchant.com/myPaymentLinkErrorPage.html, în cazul unei erori, acest errorUrl va primi următorii parametri ai șirului de interogare de la gateway: https://merchant.com/myPaymentLinkErrorPage.html?errorCode=ERROR_CODE&errorDescription=Error+message. Consultați secțiunea Coduri de eroare și descrieri pentru mai multe informații.
Pentru a crea un link URL de plată, trebuie să solicitați o operațiune Initiate Checkout
cu modul payment link
. Acesta este un exemplu de fragment pentru operațiunea Initiate Checkout
.
{ "apiOperation": "INITIATE_CHECKOUT", "checkoutMode": "PAYMENT_LINK", "interaction": { "operation": "AUTHORIZE", "merchant": { "name": "<your_merchant_name>", "url": "<website_url>" } }, "order": { "currency": "USD", "amount": 1234, "id": "<order_ID>", "description": "Ordered goods" }, "paymentLink": { "expiryDateTime": "2021-12-10T02:16:00.993Z", "numberOfAllowedAttempts": "3" } }
Referința API Initiate Checkout [REST][NVP]
Un răspuns reușit la această operațiune conține linkul URL de plată și parametrii ID-ului pentru linkul de plată, care pot fi partajați cu clientul în vederea efectuării plății.
{ "checkoutMode": "PAYMENT_LINK", "merchant": "<your_merchant_id>", "paymentLink": { "expiryDateTime": "2021-12-10T02:16:00.993Z", "id": "PAYLINK0001060519617G19059484L2", "numberOfAllowedAttempts": 3, "url": https://egenius.unicredit.ro/pbl/PAYLINK0001060519617G19059484L2 }, "result": "SUCCESS", "successIndicator": "c89f62baad174e12" }
Comerciantul partajează linkul de plată cu plătitorul pe diferite canale de comunicare, cum ar fi e-mailul, mesajele text și codurile QR. Plătitorul face clic pe linkul de plată care îl redirecționează pe pagina de plată Hosted Checkout dintr-un browser și apoi finalizează tranzacția folosind una dintre metodele de plată disponibile.
Operațiunea Delete Payment Link vă permite să ștergeți explicit sau să anulați linkul de plată dacă plătitorul a făcut deja plata offline sau dacă plata nu mai este necesară.
URL | https://egenius.unicredit.ro/api/rest/version/64/merchant/{merchantId}/link/{linkId} |
Metoda HTTP | ȘTERGERE |
Referință API Delete Payment Link [REST][NVP]
Gateway-ul închide automat sesiunea dacă:
După ce v-ați configurat contul și ați construit integrarea, trebuie să testați linkul de plată utilizând profilul de testare comerciant (ID-ul dvs. de comerciant, la care este adăugat prefixul „TEST”). Gateway-ul vă pune la dispoziție o pagină Hosted Checkout de testare, pentru verificarea linkului de plată.
Este recomandat să optați pentru serviciul de notificări, pentru a putea primi notificări Webhook în cazul în care o plată a avut succes. Pentru informații suplimentare despre notificările și configurarea Webhook, consultați Notificările Webhook.
Acest tabel descrie lista codurilor de eroare cu descrierile acestora.
Cod de eroare | Descriere |
---|---|
EXPIRED | Linkul de plată a expirat. Vă rugăm să contactați solicitantul plății. |
PAID | Comanda asociată acestui link de plată a fost plătită. Vă rugăm să contactați solicitantul plății. |
USAGE_COUNT_EXCEEDED | A fost depășit numărul maxim de încercări. Vă rugăm să contactați solicitantul plății. |
DOES_NOT_EXIST | Acest link de plată nu este valid. Vă rugăm să contactați solicitantul plății. |
UNEXPECTED_ERROR | A apărut o eroare neprevăzută. Vă rugăm să contactați solicitantul plății. |
DELETED | Acest link de plată a fost șters. Vă rugăm să contactați solicitantul plății. |