- Ghid de integrare
- Implementarea unei integrări hosted Payment Form
- Construirea unui formular de plată
Construirea unui formular de plată
Crearea și trimiterea formularului sunt pași de o importanță critică în cadrul integrării comerciant pentru un model hosted Payment Form. Câmpurile din formularul din fața plătitorului, inclusiv detaliile cardului și alte informații suplimentare sunt trimise direct către Serviciul hosted Payment Form folosind metoda HTTPS POST.
Cum se creează un formular de plată
Formularul de plată poate să conțină oricare dintre câmpurile descrise în secțiunea Referință câmpuri formular plus orice câmpuri suplimentare doriți să utilizați pentru a solicita informații de la plătitor.
Un exemplu de formular de plată HTML care colectează toate detaliile cardului este prezentat mai jos:
<form action="https://mcb.gateway.mastercard.com/form/<session_id>" method="post"> <input type="hidden" name="gatewayReturnURL" value="http://www.example.com/example"/> Card Number: <input type="text" name="gatewayCardNumber" value="" size="16" maxlength="30"/> Card Expiry Month: <input type="text" name="gatewayCardExpiryDateMonth" value="" size="2" maxlength="2"/> Card Expiry Year: <input type="text" name="gatewayCardExpiryDateYear" value="" size="4" maxlength="4"/> Card Security Code: <input type="text" name="gatewayCardSecurityCode" value="" size="4" maxlength="4"/> <input type="hidden" name="gatewayRedirectDisplayBackgroundColor" value="#808000"/> <input type="hidden" name="gatewayRedirectDisplayTitle" value="Check Your Submitted Payment Details"/> <input type="hidden" name="gatewayRedirectDisplayContinueButtonText" value="Click to Continue"/> <input type="submit" value="Continue"/> </form>
Unde:
<session_id>
= de ex.SESSION000112345678901234567890
– Identificatorul de sesiune primit la crearea sesiunii de plată în cadrul pasului Create Session.http://www.example.com/example
- Pagina de pe site-ul dvs. web unde plătitorul trebuie redirecționat. Datele plătitorului vor fi transmise prin metoda POST la această adresă după ce Serviciul hosted Payment Form a actualizat sesiunea și a aplicat validarea/ascunderea valorilor originale.
Deschideți formularul dvs. de plată într-un browser. Cu formatare, ar trebui să arate cam așa:
Formularul de plată trebuie trimis utilizând HTTPS POST după cum se poate vedea în formularul de mai sus. Mesajul POST este trimis direct către Serviciul hosted Payment Form.
Cum să colectați detalii parțiale folosind un formular de plată
Este posibil să nu doriți colectarea tuturor detaliilor cardului utilizând hosted Payment Form. De exemplu, este posibil să doriți colectarea numai a Codului de securitate card astfel încât să-l puteți utiliza în combinație cu un card stocat anterior (consultați secțiunea tokenization).
Un exemplu de formular de plată HTML care colectează numai codul de securitate al cardului este prezentat mai jos:
<form action="https://mcb.gateway.mastercard.com/form/<session_id>" method="post"> <input type="hidden" name="gatewayReturnURL" value="http://www.example.com/example"/> Card Security Code: <input type="text" name="gatewayCardSecurityCode" value="" size="4" maxlength="4"/> <input type="hidden" name="gatewayRedirectDisplayBackgroundColor" value="#808000"/> <input type="hidden" name="gatewayRedirectDisplayTitle" value="Check Your Submitted Payment Details"/> <input type="hidden" name="gatewayRedirectDisplayContinueButtonText" value="Click to Continue"/> <input type="submit" value="Continue"/> </form>
Note
name
, fie setați-l cu un nume diferit de „submit”.
Nu utilizați
<input type="submit" name="submit" value="Continue"/>
Utilizați
<input type="submit" value="Continue"/>