- Ghid de integrare
- Caracteristici acceptate (Opțiuni de plată)
- Linkuri de plată
Linkuri de plată
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.
Avantaje cheie
Principalele avantaje ale unui link de plată sunt:
- simplifică procesul de plată
- optimizează experiența utilizatorului și
- permite efectuarea mai rapidă a plăților și
- vă permite să efectuați o comunicare ulterioară cu un client după nereușita unei tranzacții sau abandonarea unui coș de cumpărături.
Utilizați un link de plată
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ă.
- Introduceți informațiile de plată, cum ar fi numărul facturii, suma totală și solicitarea de generare a unui link URL de plată.
- Gateway-ul generează un link unic pe care îl puteți partaja cu plătitorii.
- Când plătitorii fac clic pe link, aceștia sunt redirecționați către o pagină Hosted Checkout.
- Plătitorii introduc informațiile de plată pe pagina Hosted Checkout și finalizează tranzacția.
Solicitarea unei operațiuni de inițiere a validării
Cerințe preliminare
Înainte de inițierea unei operațiuni de validare, asigurați-vă că sunt setate următoarele atribute pentru linkurile de plată:
- apiOperation: Setați valoarea câmpului ca INITIATE CHECKOUT.
- checkoutMode: Setați valoarea câmpului ca PAYMENT_LINK.
- interaction.operation: Alegeți tipul tranzacției ca AUTHORIZE sau PURCHASE.
- interaction.merchant.name: Numele companiei dvs. afișat plătitorului în pagina de validare.
- interaction.merchant.url: Adresa URL a site-ului web al companiei dvs.
- order.amount: Suma totală a comenzii. Aceasta este valoarea netă plus orice comision.
- order.currency: Moneda în care se efectuează comanda.
- order.description: O scurtă descriere sub formă de text a conținutului comenzii.
- paymentLink.errorUrl: Adresa URL către care doriți să redirecționați browserul plătitorului în cazul unei erori la invocarea linkului de plată, de exemplu, dacă o comandă a fost deja plătită, un link de plată a expirat, un link de plată nu este valid și așa mai departe.
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.
Acest câmp este opțional. Dacă acest câmp nu este specificat, plătitorul, în cazul unei erori, va fi redirecționat către ecranul de eroare implicit. - order.id: Un identificator unic pentru această comandă, pentru a o distinge de orice altă comandă pe care o creați.
- paymentLink.expiryDateTime: Data și ora expirării acestui link de plată. Opțiunea implicită este de 3 luni.
- paymentLink.numberOfAllowedAttempts: Numărul de încercări permise după care plătitorul nu va mai putea plăti folosind linkul de plată. Opțiunea implicită este de 25 de încercări.
Exemplu de solicitare
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.
Exemplu de răspuns
{
"checkoutMode": "PAYMENT_LINK",
"merchant": "<your_merchant_id>",
"paymentLink": {
"expiryDateTime": "2021-12-10T02:16:00.993Z",
"id": "PAYLINK0001060519617G19059484L2",
"numberOfAllowedAttempts": 3,
"url": https://pbl/PAYLINK0001060519617G19059484L2
},
"result": "SUCCESS",
"successIndicator": "c89f62baad174e12"
}
Partajarea linkurilor de plată
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.
Ștergerea linkurilor de plată
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://api/rest/version/64/merchant/{merchantId}/link/{linkId} |
| Metoda HTTP | ȘTERGERE |
Referință API Delete Payment Link [REST][NVP]
Gateway-ul închide automat sesiunea dacă:
- plata nu este efectuată în 3 luni de la generarea linkului de plată, după care plătitorul nu va mai putea utiliza linkul de plată pentru a face plata;
- numărul de încercări de plată depășește valoarea 25, după care plătitorul nu va mai putea accesa linkul de plată pentru a finaliza tranzacția;
- plata a fost finalizată cu linkul de plată sau
- comerciantul inițiază solicitarea de ștergere.
Testați un link de plată
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ă.
- Introduceți detaliile de plată și solicitați linkul de plată prin operațiunea INITIATE_CHECKOUT. Un link URL de plată este returnat atunci când operațiunea INITIATE CHECKOUT are succes.
- Efectuați plata folosind cardul de testare indicat la Detalii testare tranzacție card
Notificări Webhook
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.
Coduri de eroare și descrieri
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. |