PayU Payment-Methods API
Retrieving payment methods allows you to remove the threat of presenting a disabled payment method with white-label integration. It also gives you the ability to retrieve stored tokens and customer card data.
Work with this as data
Every API here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for apis
7 MCP tools reach this
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/payu:payu-payment-methods-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"Discovery needs no key. Ratings and market analysis are Pro.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
OpenAPI Specification
openapi: 3.2.0
info:
version: 2.1.0
title: PayU GPO Europe REST Payment Methods API
license:
name: Apache 2.0
url: http://www.apache.org/licenses/LICENSE-2.0.html
x-logo:
url: https://poland.payu.com/wp-content/themes/global-website/assets/src/images/payu-logo.svg
description: '# Overview
This reference is designed to assist you in effectively utilizing the PayU REST API to enhance your online payment capabilities.'
servers:
- url: https://secure.payu.com
description: Production Server
- url: https://secure.snd.payu.com
description: Sandbox Test Server
security:
- Bearer:
- client_credentials
tags:
- name: Payment Methods
x-displayName: Payment Methods
description: Retrieving payment methods allows you to remove the threat of presenting a disabled payment method with white-label integration. It also gives you the ability to retrieve stored tokens and customer card data.
paths:
/api/v2_1/paymethods:
get:
tags:
- Payment Methods
summary: Retrieve All Available Payment Methods
security:
- Bearer:
- client_credentials
- trusted_merchant
operationId: retrieve-payment-methods
parameters:
- name: lang
in: query
example:
lang: pl
description: Language code, ISO-639-1 compliant, determins language of description in <code>name</code> field
required: false
schema:
type: string
examples:
lang:
summary: lang parameter value example
value:
lang: pl
- name: features
in: query
description: Determine the availability and parameters of specific features.
required: false
schema:
type: string
examples:
features:
summary: features parameter value example
value:
features: clickToPay
- name: Content-Type
in: header
description: Content type
required: true
schema:
type: string
style: simple
example: application/json
- name: Authorization
in: header
description: Auth token
required: true
schema:
type: string
style: simple
example: Bearer 3e5cac39-7e38-4139-8fd6-30adc06a61bd
responses:
'200':
x-summary: OK
description: ''
content:
application/json:
schema:
type: object
description: Section containing payment methods available for the buyer.
properties:
blikTokens:
$ref: '#/components/schemas/blikTokens'
cardTokens:
$ref: '#/components/schemas/cardTokens'
payByLinks:
$ref: '#/components/schemas/payByLinks'
status:
type: object
properties:
statusCode:
type: string
enum:
- SUCCESS
'401':
x-summary: Unauthorized
description: ''
content:
application/json:
schema:
$ref: '#/components/schemas/401'
components:
schemas:
visaFeature:
type: object
description: Click to Pay feature.
title: visa
properties:
status:
Enum:
- ENABLED
- DISABLED
type: string
description: Status of the Click to Pay feature for Visa.
example: ENABLED
dpaId:
type: string
description: Merchant ID in Visa Click to Pay.
example: jI8iGo86
acquirerBIN:
type: string
description: Acquirer Bank Identification Number for Click to Pay transactions.
example: 123456
acquirerMerchantId:
type: string
description: Acquirer Merchant ID for Click to Pay transactions.
example: MARCH01
blikTokens:
type: array
description: Section containing saved BLIK tokens
items:
type: object
properties:
value:
type: string
description: BLIK token value.
type:
type: string
enum:
- UID
- PAYID
description: Type of the token. Either UID for normal transactions or PAYID for recurring payments.
brandImageUrl:
type: string
example: https://static.payu.com/images/mobile/logos/pbl_blik.png
bankApplicationReferences:
type: array
description: Array containing objects about available installments options.
items:
type: object
properties:
key:
type: string
description: Unique key for assignment of particular banking application to a token. The value of this field is inserted in the order in payMethod.blikData.appKey field.
example: 11111
label:
type: string
description: The value of the label for assigning a particular banking application to a token. A list of values for these fields is presented to the customer for selection when paying with the UID token.
example: BLIK label
recurring:
type: object
description: Contains information about the recurring payment.
properties:
aliasLabel:
type: string
description: BLIK recurring payment title.
type:
type: string
description: Type of the recurring payment.
enum:
- O
initializationDate:
type: string
description: Date of the first transaction in the recurring payment cycle without the customer confirmation.
example: '2026-10-01T00:00:00+02:00'
format: yyyy-MM-dd'T'HH:mm:ssXXX
expirationDate:
type: string
description: Expiration date of the PAYID token. Maximum date is 10 years from the creation date of the token. If the value is not provided, token will be valid indifinitely.
example: '2026-10-01T00:00:00+02:00'
format: yyyy-MM-dd'T'HH:mm:ssXXX
mastercardFeature:
type: object
description: Click to Pay Mastercard feature.
title: mastercard
properties:
status:
enum:
- ENABLED
- DISABLED
type: string
description: Status of the Click to Pay feature for Mastercard.
example: ENABLED
dpaId:
type: string
description: Merchant ID in Mastercard Click to Pay.
example: jI8iGo86
cardTokens:
type: array
description: Section containing saved card tokens
items:
type: object
properties:
value:
type: string
example: TOKC_XATB7DF8ACXYTVQIPLWTVPFRKQE
brandImageUrl:
type: string
example: https://static.payu.com/images/mobile/visa.png
preferred:
type: boolean
example: true
status:
type: string
enum:
- NEW
- ACTIVE
- EXPIRED
example: ACTIVE
cardExpirationYear:
type: integer
example: 2026
cardExpirationMonth:
type: integer
example: 7
cardNumberMasked:
type: string
example: 411111******1111
cardScheme:
type: string
example: VS
cardBrand:
type: string
example: VISA
'401':
type: object
properties:
status:
type: object
properties:
statusCode:
type: string
description: Error type.
code:
type: string
description: Identification code of specific error.
codeLiteral:
type: string
description: Cause of the error.
statusDesc:
type: string
description: Error description.
payByLinks:
type: array
description: Section containing available PayByLink payment methods
items:
type: object
properties:
value:
type: string
example: sgb
description: <code>payType</code> value. You can find available values <b><a href="/europe/docs/get-started/introduction/#paymethods" target="_blank">here</a></b>.
brandImageUrl:
type: string
example: https://static.payu.com/images/mobile/logos/pbl_sgb_off.png
description: Link to <code><payType</code> logo graphic on PayU server.
name:
type: string
example: SGB Bank
description: Name of <code>payType</code> set by PayU
status:
type: string
enum:
- ENABLED
- DISABLED
- TEMPORARY_DISABLED
example: DISABLED
minAmount:
type: number
example: 50
maxAmount:
type: number
example: 99999999
features:
type: object
description: List of features available.
properties:
clickToPay:
$ref: '#/components/schemas/clickToPayFeature'
clickToPayFeature:
type: object
description: Click to Pay feature.
title: clickToPay
properties:
brandImageUrl:
type: string
description: URL of the Click to Pay brand image.
example: https://static.payu.com/images/mobile/logos/pbl_cpt_on.png
mastercard:
$ref: '#/components/schemas/mastercardFeature'
visa:
$ref: '#/components/schemas/visaFeature'
securitySchemes:
Bearer:
type: http
scheme: bearer
Basic:
type: http
scheme: basic