Examples

Test Redsys payment functionality with test cards. Explore different payment methods, tokenization flows, advanced operations, and transaction management examples.

Payment Methods

Different ways to process payments with Redsys.

Redirection Payment

Standard payment flow where customers are redirected to the Redsys payment gateway to complete their payment. After payment, customers are redirected back to your success or error pages.

Create payment redirect form
Redirect to Redsys payment gateway

View example

inSite Embedded Checkout

Keep customers on your site with the Redsys inSite iframe. Dynamically load the gateway, capture idOper, and complete the authorization via REST without redirecting.

Create inline checkout and load Redsys iframe
Automatically capture idOper tokens client-side

View example

DCC (Dynamic Currency Conversion)

Dynamic Currency Conversion (DCC) allows foreign customers to pay in their local currency while you receive payment in your base currency. The customer will be offered currency conversion options during checkout.

Create DCC-enabled payment redirect form
Customers see amount in base currency

View example

Tokenization

Tokenize cards and process token-based payments for recurring transactions.

MIT (Merchant Initiated Transactions)

For recurring payments and subscriptions where the merchant initiates transactions without customer presence. Uses COF type "M".

Step 1: First Payment with MIT Tokenization
Step 2: Extract Token from Notification

View example

CIT (Customer Initiated Transactions / One-Click Payments)

For one-click payments where customers are present and authorize each transaction. Uses COF types like "R" (recurring), "I" (initial), etc. Default is "R" for recurring one-click payments.

Step 1: First Payment with CIT Tokenization
Step 2: Extract CIT Token from Notification

View example

Advanced Operations

Authentication and preauthorization flows for validating and reserving funds.

Authentication Operations

Validate card data without charging the cardholder using transaction type 7. The operation is valid for 90 days and only works with VISA and MasterCard. Confirm with type 8 to charge the cardholder later.

Step 1: Create authentication operation (type 7)
Step 2: Validate card without charging cardholder

View example

Preauthorization Operations

Reserve an amount without charging immediately using transaction type 1. The operation is valid for 7-30 days and only works with VISA and MasterCard. Confirm with type 2 to charge the cardholder later.

Step 1: Create preauthorization operation (type 1)
Step 2: Reserve amount without charging cardholder

View example

Transaction Management

Refunds, cancellations, and other transaction operations.

Refund Operations

Trigger total or partial refunds through trataPeticion REST using Redsys transaction type 3. Redsys responds with 0900 when the refund succeeds.

Submit the original Ds_Order that was charged
Optionally provide partial refund amounts

View example

Cancellation Operations

Cancel preauthorizations, authorizations, refunds or split confirmations by selecting Redsys transaction types 9, 45, 46 or 47. Success responses return 0400.

Choose the exact cancellation scenario
Send the original Ds_Order and amount to cancel

View example

Test Cards

Official Redsys test cards for the sandbox environment

All cards use expiry date 12/49 and CVV 123. You can use any CVV different from 999 (except for special cases) and any future expiry date.

Important: Make sure your Virtual TPV is configured to point to the test environment (sandbox) and not production when testing. Check the official documentation for more information.

VISAEMV3DS 2.2

VISA EMV3DS 2.2 - Generic test card

MastercardEMV3DS 2.1

Mastercard EMV3DS 2.1 - Generic test card

VISAEMV3DS 2.1 Frictionless

VISA Frictionless EMV3DS 2.1

VISAEMV3DS 2.1 Frictionless

VISA Frictionless 2.1 + threeDSMethodURL

VISAEMV3DS 2.1 Challenge

VISA Challenge EMV3DS 2.1

VISAEMV3DS 2.1 Challenge

VISA Challenge 2.1 + threeDSMethodURL

American ExpressSafeKey 1.0.2

American Express SafeKey 1.0.2

Diners Club1.0.2

Diners Club International 1.0.2

JCBJSecure 1.0.2

JCB JSecure 1.0.2

Special CVV cases: Use CVV 999, 172, 173 or 174 with the generic VISA card to simulate different types of denials. Check the documentation for more details.

Resources