Shopify Integration

​

Overview

Customers enter their card details in Shopify as usual, while Revolv3 securely processes the payment in the background. This guide describes how to integrate Shopify with Revolv3 using a Custom Payment App (Credit Card Payment Extension). The integration enables merchants to accept card payments directly within Shopify checkout while using Revolv3 as the backend payment gateway.

​

Key Features

• Seamless checkout experience (no redirects)
• Card data handled securely by Shopify
• Revolv3 processes payments via configured processor
• Support for charge and refund operations

​

Architecture

The integration consists of the following components:

• Shopify Checkout – collects and tokenizes card data
• Shopify Payment Extension – app installed by merchant
• Revolv3 Integration Service – backend handling payment requests
• Processor – executes transaction processing

​

High-Level Flow

Shopify Checkout → Revolv3 Integration → Processor → Revolv3 → Shopify

• Shopify handles customer interaction and card data
• Revolv3 handles payment processing and routing

​

Payment Flow

​

Charge (Payment)

1. Customer enters card details in Shopify Checkout
2. Shopify tokenizes card data
3. Shopify sends request to Revolv3
4. Revolv3 transforms request to processor format
5. Payment is processed by the processor
6. Revolv3 returns response
7. Shopify updates order status

​

Refund

1. Merchant initiates refund in Shopify Admin
2. Shopify sends request to Revolv3
3. Revolv3 sends refund request to processor
4. Processor returns result
5. Revolv3 returns response to Shopify
6. Shopify updates refund status

​

Supported Features

​

Quick Start

To start using Revolv3 as a payment provider:

1. Install the Revolv3 payment app in Shopify
2. Log in to Revolv3 portal when prompted
3. Add your store domain
4. Activate the payment provider in Shopify

​

Step 1: Open Payment Settings

• Log in to your Shopify Admin
• Go to Settings → Payments

​

Step 2: Add Revolv3

• Click See all providers
• Search for Revolv3
• Select it as your payment provider

​

Step 3: Connect Your Account

• Grant required permissions. You must grant Revolv3 access to read and write payment sessions
• You will be redirected to Revolv3
• Log in to your Revolv3 account. You need to log in and specify your store’s domain in the merchant settings
• Add your store domain

​

Step 4: Activate Payments

• Return to Shopify
• Click Activate

Your store is ready to accept payments.

​

Configuration

No manual configuration is required from the merchant side. All technical setup, including:

• payment processing endpoints
• processor configuration
• security setup

is handled automatically by Revolv3 during onboarding and app installation. Merchants only need to install and activate the Revolv3 payment app in Shopify.

​

Backend Responsibilities

The Revolv3 backend is responsible for:

• Processing payment session requests
• Processing refund session requests
• Mapping Shopify requests to Revolv3 API
• Handling processor communication
• Returning Shopify-compliant responses

​

Security & Compliance

Revolv3 is designed to provide secure and compliant payment processing while minimizing the compliance burden for merchants.

​

Card Data Handling

• Card details are entered directly in Shopify Checkout
• Shopify securely handles and tokenizes card data
• Revolv3 receives only tokenized payment information
• Revolv3 does not store or process raw cardholder data

​

PCI DSS Scope

Since card data is collected and processed by Shopify, merchants using Revolv3 fall under a reduced PCI DSS scope (SAQ-A). This means:

• No direct handling of card data by the merchant
• No storage of sensitive card information
• Simplified PCI compliance requirements

Revolv3 operates as a PCI-compliant payment gateway and processes transactions using secure, tokenized data.

​

Secure Communication

All communication between Shopify and Revolv3 is secured using industry-standard mechanisms:

• Encrypted HTTPS connections
• HMAC-SHA256 signature verification
• Certificate-based validation
• Domain verification (store-level access control)

​

Data Protection & Privacy

Revolv3 supports Shopify’s data protection requirements and complies with applicable regulations such as GDPR and CCPA. The integration includes mandatory webhook handling for:

• Customer data access requests
• Customer data deletion requests
• Shop data deletion requests

Revolv3 processes such requests within the required regulatory timeframes.

​

Key Security Principles

• No card data exposure outside Shopify
• Tokenized payment processing
• Encrypted data transmission
• Strict access control per merchant/store

​

Deployment Model

​

Shopify

• App registration via Partner Dashboard
• Payment extension configuration
• Endpoint registration

​

Revolv3

• Backend hosted externally (e.g. Azure Functions)
• Payment processing logic
• Database and configuration

Note: No backend code is deployed to Shopify

​

Testing

Use the following environments:

• Shopify Partner Development Store
• Revolv3 Sandbox
• Shopify test card numbers

Validate:

• Payment flow
• Refund flow
• Error handling
• Webhook processing

​

Limitations

Current implementation limitations:

• Card payments only
• No 3DS support
• No auth/capture separation
• No void functionality
• No alternative payment methods
• No subscriptions

​

Troubleshooting

​

Common Issues

Payment not processed

• Check endpoint availability
• Verify API credentials
• Validate request schema

Activation button disabled

• Ensure store domain is configured in Revolv3

​

Summary

The Shopify–Revolv3 integration provides a seamless way to process card payments directly within Shopify checkout while leveraging Revolv3 as the payment gateway. This integration:

• Minimizes PCI scope
• Ensures secure processing
• Provides scalable backend architecture
• Aligns with Shopify payment platform requirements

​

Frequently Asked Questions (FAQ)

​

Do I need any technical setup to use Revolv3?

No. There is no manual configuration required. You only need to install the Revolv3 payment app in Shopify, connect your account, and activate it. All technical setup is handled automatically.

​

Where do my customers enter their card details?

Customers enter their card details directly in Shopify checkout. Revolv3 processes the payment securely in the background.

​

Will customers be redirected to another page?

No. The entire checkout process happens within Shopify. There are no redirects to external payment pages.

​

What payment methods are supported?

Currently supported:

• Credit cards
• Debit cards

Not supported (yet):

• Apple Pay
• Google Pay
• Alternative payment methods

​

Can I issue refunds?

Yes. You can issue refunds directly from Shopify Admin. Revolv3 will process the refund automatically.

​

Can I void a transaction?

No. Void functionality is not supported in the current version.

​

Do you support 3D Secure (3DS)?

Not at the moment. 3DS support is planned for a future release.

​

Why can’t I activate Revolv3 in Shopify?

Most likely reason:

• Your store domain has not been configured in Revolv3

Make sure you complete the setup in the Revolv3 portal before returning to Shopify.

​

Who should I contact if something doesn’t work?

Please contact your Revolv3 support team or account manager.