Guides
Start typing to search…

Payment APIs

Complete headless payment processing with Vrio APIs for orders, transactions, and payment method integration.

Vrio's Payment APIs provide complete flexibility for headless payment processing, allowing you to build custom checkout experiences while leveraging Vrio's powerful backend capabilities including payment routing, subscription management, and fraud prevention.

Overview

Whether you're building a custom storefront, mobile app, or integrating Vrio into an existing system, the Payment APIs give you full control over the order and payment flow. You can process orders in multiple ways depending on your needs:

  • Multi-step flows - Create orders, add offers, collect information progressively
  • Single-step processing - Process everything in one API call
  • Alternative payment methods - PayPal, Apple Pay, Google Pay, Klarna, Afterpay
  • Secure transactions - 3D Secure authentication for enhanced security
  • Subscription management - Create and manage recurring billing

Core Concepts

Order Lifecycle

Every order in Vrio follows a basic lifecycle:

  1. Create - Initialize an order with basic information
  2. Configure - Add offers, set addresses, apply discounts
  3. Process - Submit payment and finalize the transaction
  4. Manage - Update payment methods, handle renewals, process refunds

Response Codes

Understanding response codes is critical for handling different payment scenarios:

  • 100 - Success - Order processed successfully
  • 101 - Additional action required - Used for 3DS, PayPal redirects, etc.
  • 200 - Declined - Payment was declined (check transaction object for details)

Learn more about handling 101 response codes →

Processing Approaches

Multi-Step Processing

Build checkout flows that collect information progressively across multiple pages or steps. This is the most flexible approach and recommended for most implementations. Also supports post-purchase upsells by presenting additional offers after the initial transaction.

Best for: Multi-page checkouts, cart abandonment tracking, progressive data collection, post-purchase upsells

Learn more:

Single-Step Processing

Process everything in one API call when you have all information upfront. Simplest approach for streamlined checkouts. Can also be used when presenting upsells during checkout before payment submission.

Best for: One-page checkouts, mobile app purchases, quick buy flows, pre-checkout upsells

Learn more:

Alternative Payment Methods

Support non-card payment methods like PayPal, Klarna, and Afterpay, as well as digital wallets like Apple Pay and Google Pay that require additional handling.

Learn more:

3D Secure Flows

Implement Strong Customer Authentication (SCA) for enhanced security and regulatory compliance.

Learn more:

Key Concepts

Response Codes

Understanding response codes is critical for handling different payment scenarios:

  • 100 - Success - Order processed successfully
  • 101 - Additional action required - Used for 3DS, PayPal redirects, etc.
  • 200 - Declined - Payment was declined (check transaction object for details)

Learn more about handling 101 response codes →

Duplicate Prevention

Vrio automatically prevents duplicate orders through intelligent matching logic based on order characteristics, particularly useful for handling declined transactions and retry attempts without creating redundant orders.

Learn how duplicate prevention works →

Tracking Variables

Pass custom tracking data with orders to measure campaign performance, attribution, and conversion metrics. Support for up to 20 tracking variables per order.

Learn about tracking variables →

Upsell Processing

Maximize order value by processing upsells and cross-sells programmatically.

Learn more:

Getting Started

Ready to start building? Follow these steps:

  1. Get API Keys - Set up authentication
  2. Review API Order Placement - Learn the two-step process
  3. Explore Recipes - See implementation examples
  4. API Reference - Full endpoint documentation

Updated 6 days ago