Operațiunea de anulare este una dintre operațiunile de plată de bază, care asigură anularea operațiunii de plată deja efectuate în contul titularului de card.
Procesul de anulare este următorul:
Crearea unei anulări
Tranzacția poate fi inițiată prin apel:
gptom://transaction/cancel?…
în care următorii parametri sunt utilizați pentru a crea raportul, inclusiv amsID care este atribuit fiecărei plăți:
Variabilă/câmp
Format/Format
Descriere/Descriere
Exemplu
clientID
string
amsID OBLIGATORIU
string
CZ: AmsID unic pe care îl veți primi la momentul plății.
RO: AmsID unic pe care îl veți primi la momentul plății.
RO: AmsID unic pe care îl veți primi la momentul plății.
redirectUrl
string
CZ: URL-ul aplicației dvs. către care redirecționăm clientul după ce anularea este finalizată.
EN: URL-ul aplicației dvs. către care vom redirecționa clientul după finalizarea anulării.
EN: URL-ul aplicației dvs. către care vom redirecționa clientul după finalizarea anulării.
fb://Success
preferabilReceiptType
enum (sms,email,qr,print)
GP tom API CZ: În cazul trimiterii unei chitanțe din aplicație, este posibil să se predefinească metoda de trimitere a chitanței prin .
GP tom API
Valorile posibile sunt: RO: În cazul trimiterii unei chitanțe din aplicație, este posibil să se predefinească metoda de trimitere a chitanței prin intermediul . Valorile posibile sunt: PHONE EMAIL QR PRINT
GP tom API
Valorile posibile sunt: RO: În cazul trimiterii unei chitanțe din aplicație, este posibil să se predefinească metoda de trimitere a chitanței prin intermediul . Valorile posibile sunt: PHONE EMAIL QR PRINT
text
printByPaymentApp
bool
GP tom GP tom RO: definește dacă chitanța este transmisă clientului de către aplicația dvs. sau de către . Valoarea implicită este true (adică va oferi metoda de transmitere a chitanței către client). Dacă trimiteți o valoare de "false", vom returna utilizatorul la aplicația dvs. imediat după tranzacție și va depinde de dvs. să predați chitanța.
GP tom RO: Definește dacă chitanța este transmisă clientului de către aplicația dvs. sau . Valoarea implicită este true (adică GP va oferi o metodă de transmitere a chitanței către client). Dacă trimiteți o valoare de "false", returnăm utilizatorul la aplicația dvs. imediat după tranzacție și depinde de dvs. să transmiteți chitanța.
GP tom RO: Definește dacă chitanța este transmisă clientului de către aplicația dvs. sau . Valoarea implicită este true (adică GP va oferi o metodă de transmitere a chitanței către client). Dacă trimiteți o valoare de "false", returnăm utilizatorul la aplicația dvs. imediat după tranzacție și depinde de dvs. să transmiteți chitanța.
adevărat/fals
clientPhone
string
CZ: Numărul de telefon al clientului.
RO: Numărul de telefon al clientului.
RO: Numărul de telefon al clientului.
+420606505404
clientEmail
string
CZ: Adresa de e-mail a clientului.
EN: Adresa de e-mail a clientului.
EN: Adresa de e-mail a clientului.
info@gptom.com
Exemplu de apel:
gptom://transaction/cancel?amsID=123&preferableReceiptType=QR&clientPhone=+420606505404&clientID=123&printByPaymentApp=true&redirectUrl=gp://transaction/cancel&clientEmail=info@gptom.com
Răspunsul va conține următoarele câmpuri:
Câmp/câmp
Descriere/Descriere
Exemplu/Exemplu
STAREA SARCINII
CZ: Oferă răspunsul la întrebarea în ce stare s-a încheiat solicitarea.
RO: Oferă informații cu privire la starea în care s-a încheiat solicitarea dumneavoastră.
RO: Oferă informații cu privire la starea în care s-a încheiat solicitarea dumneavoastră.
FINALIZAT ANULAT EROARE
terminalID
CZ: ID-ul terminalului pe care sunt procesate tranzacțiile.
Identifică terminalul în sistemele GP. RO: ID unic al terminalului pe care este prelucrată tranzacția.
Identifică terminalul în sistemele GP. RO: ID unic al terminalului pe care este prelucrată tranzacția.
12345678
amount
CZ: Suma determină volumul tranzacției. Această sumă este calculată în moneda națională utilizată de terminal. Pentru o închidere, aceasta include toate tranzacțiile cu cardul, creditate minus debitate.
RO: Suma determină volumul tranzacției. Această sumă este calculată în moneda națională utilizată de terminal. La o zi de închidere, aceasta conține toate tranzacțiile cu cardul, creditate minus debitate.
RO: Suma determină volumul tranzacției. Această sumă este calculată în moneda națională utilizată de terminal. La o zi de închidere, aceasta conține toate tranzacțiile cu cardul, creditate minus debitate.
10
batchNumber
CZ: Identifică numărul de închidere. Se completează în cazul în care se solicită un termen limită.
RO: Definește numărul lotului. Prezent în timpul tranzacției de închidere a lotului.
RO: Definește numărul lotului. Prezent în timpul tranzacției de închidere a lotului.
1
emvAppLabel
CZ: Numele EMV care a fost utilizat la plată.
RO: Eticheta cardului utilizat
RO: Eticheta cardului utilizat
Visa Debit
amsID
CZ: Număr unic de tranzacție.
RO: Număr unic de tranzacție.
RO: Număr unic de tranzacție.
referenceNumber
CZ: Numărul de referință introdus la solicitarea plății.
RO: Numărul de referință introdus în timpul cererii de plată
RO: Numărul de referință introdus în timpul cererii de plată
ABC123
sequenceNumber
CZ: utilizat pentru tranzacțiile de anulare. Utilizați valoarea primită care făcea parte din tranzacția pe care doriți să o anulați.
RO: Utilizat pentru anularea tranzacției. Se utilizează valoarea primită care făcea parte din tranzacția pe care doriți să o anulați.
RO: Utilizat pentru anularea tranzacției. Se utilizează valoarea primită care făcea parte din tranzacția pe care doriți să o anulați.
001000000
transactionType
RO: Definește tipul de tranzacție.
RO: Definește tipul de tranzacție.
RO: Definește tipul de tranzacție.
CARD
date
CZ: Indică ora tranzacției.
RO: Indică data tranzacției.
RO: Indică data tranzacției.
2024-10-29T12:14:00.112Z
currencyCode
CZ: Coduri valutare ISO din trei cifre - consultați pagina Wiki pentru o listă.
EN: Cod valutar ISO cu trei caractere.
EN: Cod valutar ISO cu trei caractere.
EUR
merchantID
CZ: ID unic al comerciantului, de obicei ID al locației. RO: ID unic al comerciantului, de obicei ID al locației
tipAmount
CZ: Sfaturi. Completat în cazul în care a fost introdus.
RO: Sfat. Completat dacă este necesar.
RO: Sfat. Completat dacă este necesar.
2
totalAmount
CZ: Indică valoarea totală a tranzacției (inclusiv bacșișul). RO: Indică valoarea totală a tranzacției (inclusiv bacșișul)
12
result
CZ: Răspuns la cerere.
RO: Rezultat la cerere.
RO: Rezultat la cerere.
0 = finalizat -1 = refuzat
cardEntryMode
CZ: identifică modul în care au fost introduse datele cardului, cum ar fi cip, fără contact, bandă magnetică etc. RO: definește modul în care a fost citit cardul: bandă magnetică, cip sau fără contact.
CONTACTLESS
transactionID
CZ: ID unic generat de aplicația de plată în timpul procesului de înregistrare a tranzacției.
EN: ID unic generat de aplicația de plată în timpul procesului de înregistrare a tranzacției.
EN: ID unic generat de aplicația de plată în timpul procesului de înregistrare a tranzacției.
001000000
authorizationCode
CZ: Se completează numai în cazul în care tranzacția este aprobată.
RO: Este prezentă doar dacă tranzacția este procesată.
RO: Este prezentă doar dacă tranzacția este procesată.
123456
cardNumber
CZ: Numărul cardului (PAN). Este prezent în formă mascată.
RO: Numărul cardului (PAN). Este prezent în formă mascată.
RO: Numărul cardului (PAN). Este prezent în formă mascată.
0001
pinOk
adevărat/fals
COD
CZ: Afișează rezultatul tranzacției pe partea de autorizare.
RO: Afișează rezultatul tranzacției pe partea de autorizare.
RO: Afișează rezultatul tranzacției pe partea de autorizare.
aprobat