Payment link

1 Introduction

Use this service to generate a payment link. The link may be an element of a message that is sent to a Customer. When the Customer clicks on the link he or she is redirected to a PayU page that displays order details, amount to be paid and payment methods.

Sample message including the payment link that is sent by a Seller or Service Provider:

Dear Madam,

further to our earlier telephone conversation, I send you a link to the insurance policy payment.

Payment lik is valid till: MM.DD.RR

If you have any questions, please contact our Customer Service specialists by calling xxx xxx xxx. You may contact us from Monday to Friday, between 8.00 am and 7.00 pm and on Saturday from 8.00 am to 4.30 pm.

Kind regards,

XXX

Requirements and recommendations for the Payment Link service

Before you integrate this service, please review the recommendations and requirements related to the usege of the payment link.

1.1 Service integration

The payment link is based on regular PayU integration involving REST API described in: Creating a new order. The validityTime field serves as an extension. It is included in the OrderCreateRequest message that indicates the payment link expiry date.

Sample order that includes basic buyer’s details, external identifier (extOrderId) and payment link expiry date set to 24h (validityTime):

                    curl -v -X POST https://secure.payu.com/api/v2_1/orders \
                    -H "Content-Type: application/json" \
                    -H "Authorization: Bearer 3e5cac39-7e38-4139-8fd6-30adc06a61bd" \
                    -d '{
                          "notifyUrl":"https://your.eshop.com/notify",
                          "customerIp":"127.0.0.1",
                          "merchantPosId":"145227",
                          "description":"Car insurance",
                          "currencyCode":"PLN",
                          "totalAmount":"15000",
                          "extOrderId": "[generateExtOrderId]",
                          "validityTime":"86400",
                          "products":[
                             {
                                "name":"Car insurance",
                                "unitPrice":"15000",
                                "quantity":"1"
                             }
                          ],
                          "buyer": {
                             "email": "john.doe@example.com",
                             "phone": "654111654",
                             "firstName": "John",
                             "lastName": "Doe"
                          }
                        }'

Authentication methods are described in: Signing API calls parameters.

Sample response to a new order request:

                    { 
                      "status":{ 
                        "statusCode":"SUCCESS",
                      },
                      "redirectUri":"{payment_summary_page_url}",
                      "orderId":"WZHF5FFDRJ140731GUEST000P01",
                      "extOrderId":"{your_order_identifier}",
                    }'

The redirectUri field includes payment link. The link payment validity time (validityTime) is provided in seconds. The minimum value is one (1) second and the maximum one is three months (8035200 seconds).

PayU automatically cancels only payments with "new" status. If the payment gateway has already been selected and payment is flagged as "pending", then in order to cancel payment the method described HERE should be called.

PayU informs the Seller or Service Provider about the payment by submitting a notification to the address provided in the order in the notifyUrl parameter. To learn more about notifications, read Notifications.