openapi: 3.1.0 info: version: 2.1.0 title: PayU GPO Europe REST Authorize MCP 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. Whether you''re running an e-commerce store or developing applications that require secure and seamless payment processing, our API offers a range of features to meet your needs. Our API offers a comprehensive set of endpoints to empower you with full control over your payment processes. With these endpoints, you can seamlessly create, capture, cancel, and retrieve orders, conduct payouts, and access essential reports. For more details on the integration, please refer to the official PayU documentation. It provides comprehensive explanations, code samples, and best practices for seamless integration of the PayU API into your applications. ## Testing ### Production Environment For a basic integration, including only a redirection to PayU hosted payment page, it is perfectly enough to use the public test point of sale. However, if you would like to test a full set of endpoints, including e.g. refunds, consider registering for a sandbox account. **Public Test POS (point of sale)** | Key name | Value | | ------------------------------ | -------------------------------: | | POS ID (pos_id) | 145227 | | OAuth protocol - client_id | 145227 | | Second key (MD5) | 13a980d4f851f3d9a1cfc792fb1f5e50 | | OAuth protocol - client_secret | 12f071174cb7eb79d4aac5bc2f07563f | ### Sandbox Environment Sandbox is an almost identical copy of PayU production system. It can be used for integration and testing purposes. **Public Test POS (Point of Sale)** Although it is best to create your own account to later be able to configure it as needed, you may also use a public sandbox test POS without registering: | Key name | Value | | ------------------------------ | -------------------------------: | | POS ID (pos_id) | 300746 | | OAuth protocol - client_id | 300746 | | Second key (MD5) | b6ca15b0d1020e8094d9b5f8d163db54 | | OAuth protocol - client_secret | 2ee86a66e5d97e3fadc400c9f19b065d | The availability of the sandbox environment can be checked on the Status page. **Testing Card Payments** In order to test card payments on sandbox, please use credentials displayed on the Sandbox documentation page.' 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: MCP x-displayName: Multi-Currency Pricing description: We can convert your customers' payments to the currency of your shop set up with PayU. paths: /api/v2_1/mcp-partners/{mcpPartnerId}/fx-table: get: tags: - MCP summary: Retrieve Rate Table description: Retrieve current table with the conversion rates for the currencies. operationId: retrieve-rate-table parameters: - name: mcpPartnerId in: path example: 6283a549-8b1a-430d-8a62-eea64327440e required: true content: application/json: schema: type: string - 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 properties: id: type: string example: 802438 description: rate table id (corresponds with mcpFxTableId in OrderCreateRequest) validTo: type: string format: '2017-06-27T20:20:00Z' example: '2023-01-02T20:18:00Z' description: table validity time (always in UTC). New table should be retrieved right after the validity ends. currencyPairs: type: array description: Section containing pairs of chosen term currency and base currencies items: type: object properties: baseCurrency: type: string example: PLN description: initial currency code - this is the currency in which the payer will be charged (card settlement currency) compliant with ISO 4217 exchangeRate: type: number example: 0.23753 description: exchange rate from base currency to term currency termCurrency: type: string example: USD description: final currency code - this is the currnecy of the shop at which the payment will be processed (currency set for the shop in the PayU system) compliant with ISO 4217 '400': x-summary: Bad request description: '' content: application/json: schema: $ref: '#/components/schemas/400' '401': x-summary: Unauthorized description: '' content: application/json: schema: $ref: '#/components/schemas/401' '404': x-summary: Not found description: '' content: application/json: schema: $ref: '#/components/schemas/404' components: schemas: '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. '400': type: object properties: status: type: object properties: statusCode: type: string description: Error type. severity: type: string description: error severity type. code: type: string description: Identification code of specific error. codeLiteral: type: string description: Cause of the error. statusDesc: type: string description: Error description. '404': type: object properties: status: type: object properties: statusCode: type: string description: Error type. severity: type: string description: error severity type. statusDesc: type: string description: Error description. securitySchemes: Bearer: type: http scheme: bearer Basic: type: http scheme: basic