PUSH payments

Creating a PUSH Payment

This menu enables creating a PUSH payment. In the first step, the user enters data for the PUSH payment to a form (see Picture No. 16). Items marked with an asterisk are required:

• E-shop: option to choose an e-shop from the list of e-shops, which have enabled PUSH payments, see the menu “E-shops: Authorization for payment” menu,
• Payment number:
  • It can contain only numbers and its maximum length is 15 characters,
  • The number has to be unique within the e-shop,
  • The user has an option to use the “Create payment number” button to create a unique payment number by the system,
• Processing method:
  
  • After selecting the option to “Pay the amount”, there is created the payment, which will be immediately, after the customer pays it on the GP webpay payment gateway, captured from the customer’s account,
  • After selecting the option to “Block the amount” there is created the payment, which will be immediately, after the customer pays it on the GP webpay payment gateway, blocked on the customer’s account. The user has an option to make a payment and to capture the amount from the customer’s account later be means the GP webpay Portal (the menu “Payments”) or using the Web Services,
• Amount: the amount requested to be paid; decimals can be used as well
• Reference number:
  • Optional identifier that can help work with the payment, e.g. invoice number,
  • It can contain these ASCUII characters: x20(space), x23(#), x24($), x2A-x3B(*+,-./0- 9:;), x3D(=), x40-x5A(@A-Z), x5E(^), x5F(_), x61-x7A(a-z),
  • Maximum allowed length is 20 characters,
  • The number might not be unique, it can be repeated.
• Language: option to choose the language of e-mail template and of the GP webpay payment gateway,
• Order number:
  
  • Optional identifier that can help the merchant his/her work with the payment,
  • It can contain only numbers and its maximum length is 30 characters,
  • The number might not be unique, it can be repeated.
• Valid to:
  
  • By default, PUSH payment is valid for 90 days,
  • The user can specify their own expiry date (maximum is 90 days from the date of creation), until then the customer can use the payment link for payment,
  • After expiration, the payment link is invalid and it cannot be used for payment.
• Currency: option to choose the currency from the list.
• E-shop data: data entered will be sent in the request for creating a payment to the GP webpay payment gateway interface in the “MD” parameter (see the document “GP webpay API HTTP - Technická specifikace pro vývojáře” in the “Downloads” menu) and will be returned to the e-shop in the response from the GP webpay payment gateway in the unchanged form,
• Payment description: data entered will be sent in the request for creating a payment to the GP webpay payment gateway interface in the “DESCRIPTION” (see the document “GP webpay API HTTP - Technická specifikace pro vývojáře” in the “Downloads” menu).
• Type of payment:
  
  • following the choice of the “Recurring payment” option, the card details are stored for this functionality after the capturing of a PUSH payment,
  • following the choice of the “Card on file” option, the card details are stored for this functionality after the capturing of a PUSH payment.

After entering data for PUSH payment in the form, it goes to the second (facultative) step of “Entering e-mail” by pressing the “Continue” button.

In the second step, the user has an option to enter customer’s e-mail address to send payment link and/or to enter e-mail address of e-shop to send confirmation of settlement of the payment link.

If the option “Send payment link to client by e-mail” is selected, a form is displayed (see Picture No. 17). Items marked with an asterisk are required:

• To: customer’s e-mail address,
• Subject: text for the subject of the message can be changed by the user,
• Message: text of message to be sent to the customer can be modified by the user. Nevertheless, it is necessary to preserve the text string “${link}” (without the quotation marks), which will be replaced, when sending a message, by the created payment link.

If the option “E-mail to send confirmation of payment” is selected, a form is displayed (see Picture No. 18). Items marked with an asterisk are required:

• To: e-mail address of the e-shop,
• Payment description: data entered will be sent in the request for creating a payment to the GP webpay payment gateway interface in the “DESCRIPTION” (see the document “GP webpay API HTTP - Technická specifikace pro vývojáře” in the “Downloads” menu).

To the last, third step “Push Payment Summary”, it goes by pressing the “Continue” button.

In the last, third step, there are displayed data about the created PUSH payment and about the entered e-mail addresses (see Picture No. 19). After entering the password to the private key and after pressing the “Create payment link” button, there is displayed confirmation about the successful creating a PUSH payment and about sending it to the given e-mail address (see Picture No. 20). The “Payment link” contains the created payment link, which the user can store to the clipboard and use it in other application. The created payment link cannot be changed.

The user can create other PUSH payment by pressing the “Create another PUSH payment” button.

The user has the option to search in created PUSH payments by pressing the “Search for PUSH payments" button. Search filter is displayed (see Picture No. 21).

Capturing a PUSH payment

The customer receives e-mail informing about the created PUSH payment with the payment link. If the customer decides to pay it, he/she clicks the payment link and the browser redirects him/her to the GP webpay payment gateway, where he/she makes the payment. The customer is then informed about the result of payment:

• Payment has been processed successfully:
  
• Payment was unsuccessful:
  
• The limit of payment attempts has been exceeded:
  

If the customer is not redirected to the GP webpay payment gateway after clicking the payment link, the customer is informed about the reason:

• Payment has already been done:
  
• Payment not found:
  
• Payment has been cancelled:
  
• Payment has already expired:
  
• PUSH payments are not authorized for the e-shop:
  
• Payment is in an inconsistent state:
  

PUSH payment can be created also using the Web Services (method “createPaymentLink()”), see the document “GP webpay API WS - Technická specifikace pro vývojáře“ in the “Downloads” menu.