Skip to content

Postman Collection

You can use the following Postman collection to interact with the Ratepay APIs in the integration environment.

The collection covers common payment flows and can be used as a reference or starting point for custom integrations.

Download: ratepay_postman_collection_integration.zip

Covered APIs

  • Payment API 2.0 (JSON)
    • Authorization
    • Capture
    • Refund
    • Cancellation
    • Incremental Authorization
    • Shipping Information
  • Payment API 1.8 (XML)
    • PROFILE_REQUEST (get configuration for specified credentials)
    • CONFIGURATION_REQUEST (get configuration for Pay in 3)
    • CALCULATION_REQUEST (for Pay in 3)
    • PAYMENT_INIT (Initialization)
    • PAYMENT_REQUEST (Authorization)
    • PAYMENT_CONFIRM (Handshake)
    • CONFIRMATION_DELIVER (Capture)
    • PAYMENT_CHANGE (change-order, credit, cancellation, return)
  • Hosted Payment Page (HPP)
    • Create session
    • Receive session record(s)
  • One Time Passcode (OTP) API
    • Validate an OTP code
    • Regenerate OTP code
  • Transaction Status API
    • Get order status

Getting Started

1. Import the Collection

Import the Ratepay Payment API 2.0 (Integration).postman_collection.json / Ratepay Payment API 1.8 (Integration).postman_collection.json into Postman.

2. Test Data & Credentials

This collection comes with generally available public credentials & is ready-to-use.

All other variables (tokens, IDs) are set automatically by test scripts.

Included personal data (names, addresses, IBANs, emails...) are fictional test data.

No production data is used.

Authentication

Most APIs use OAuth 2.0 Client Credentials.

Run the following request first:

0 - 🔑 Request OAuth Token

The access token is automatically stored and reused by subsequent requests.

Notes

Base URLs point to the integration environment

The collection is intended for demonstration and testing purposes

 
Â