Skip to main content

Retrieve Payment Methods

To showcase payment methods on your store page, you should first retrieve them from PayU. This allows you to then associate them with the buttons on your website for a seamless presentation.

GET Request Body

When making GET requests, please remember not to include any data in the request body, as specified in the RFC 9110 standard. Requests that do not adhere to this requirement will be rejected by PayU with an HTTP 403 status.

To display payment methods on your custom checkout page, you need to retrieve them from PayU and then link them to the buttons on your site. To do so, first obtain an OAuth access token as described in the Authorize and Order section. Once you have the access token, include it in the request header and use the GET method to send a request to the api/v2_1/paymethods endpoint.

This will return the available payment methods that you can then integrate and present to your customers on your checkout page.

curl -X GET https://secure.payu.com/api/v2_1/paymethods \
    -H "Authorization: Bearer 87ad751f-7ea5-4023-a16f-04b6647a07f5"
    -H "Cache-Control: no-cache"

If the request to retrieve the payment methods was successful, you will receive a response containing all available payment methods.

Example of the Positive response (HTTP 200)
{

   "payByLinks":[
      {
         "value":"c",
         "name":"Płatność online kartą płatniczą",
         "brandImageUrl":"http://static.payu.com/images/mobile/logos/pbl_c.png",
         "status":"ENABLED"
         "minAmount": 50,
         "maxAmount": 100000
      },
      {
         "value":"o",
         "name":"Pekao24Przelew",
         "brandImageUrl":"http://static.payu.com/images/mobile/logos/pbl_o_off.png",
         "status":"DISABLED"
         "minAmount": 50,
         "maxAmount": 100000
      },
      {
         "value":"ab",
         "name":"Płacę z Alior Bankiem",
         "brandImageUrl":"http://static.payu.com/images/mobile/logos/pbl_ab_off.png",
         "status":"TEMPORARY_DISABLED"
         "minAmount": 50,
         "maxAmount": 100000
      }
   ]
}

For detailed information on the parameters and the authorization methods, please refer to the Retrieve Payment Methods section in our API Reference.