Alternative payments

Sign in Hub
Get help
Alternative payments
Validate PayPal amount codes and APM sandbox fields for method-specific checkout outcomes

Use sandbox amount codes and method-specific fields to trigger checkout outcomes. Each method lists the values that apply to init payment.

Bizum
anchor

Guide
Integrate Bizum for the Spanish market to enable instant peer-to-peer bank payments directly from customer mobile banking applications. Bizum sandbox uses amount-based outcomes to simulate payment scenarios. Use the init payment API v1 required fields with specific:

  • amount to match the success or error flow
  • customer_phone +34700000000
AMOUNT
400
SUCCESS
success
Amount should be less than 500.
AMOUNT
700
ERROR 1.01
declined : {code: Guide
Cardholder authentication failed; check credentials, session, and integration before retrying. 1.01 , message: "Authentication failed"}
Amount should be between 500 and 1000.
AMOUNT
1200
ERROR 5.03
declined : {code: Guide
An application error occurred while processing the transaction; retry later or contact support if it continues. 5.03 , message: "Application error"}
Amount should be between 1000 and 1500.
AMOUNT
1600
ERROR 3.05
declined : {code: Guide
The cardholder should contact their bank for further information. 3.05 , message: "Call your bank"}
Amount should be greater than 1500.

Blik One-time
anchor

Guide
Accept BLIK payments in Poland with one-time authorization codes that let customers pay directly from their bank accounts in real time. Blik One-time uses a 6-digit code to trigger specific outcomes. Use the init payment API v1 required fields with specific:

  • amount to match the error flow
  • payment_type_data.blik_code
BLIK CODE
777987
DIRECT
success
BLIK CODE
777123
REDIRECT
success
BLIK CODE
960111
PAYMENT DECLINED
declined
AMOUNT
31200
BLIK CODE
777567
TIMEOUT PAYMENT EXPIRED
declined : {code: Guide
The customer could not finalize the payment during the given timeframe, which resulted in order expiration. 0.02 , message: "Order expired"}
AMOUNT
12000
INSUFFICIENT FUNDS
declined

Blik Recurring
anchor

Guide
Accept BLIK Recurring in Poland with a one-time mandate setup that lets merchants charge a customer's bank account automatically without re-authentication for each transaction. Blik Recurring uses a 6-digit code to trigger specific outcomes for the recurring mandate setup. Use the init payment API v1 required fields with specific:

  • payment_method_flow direct
  • future_usage.payment_type unscheduled
  • payment_type_data.blik_code
BLIK CODE
999009
DIRECT
success
BLIK CODE
777123
TIMEOUT PAYMENT EXPIRED
declined : {code: Guide
The customer could not finalize the payment during the given timeframe, which resulted in order expiration. 0.02 , message: "Order expired"}


Boleto
anchor

Guide
Accept Boleto Bancário payments in Brazil with voucher-based checkout that lets customers pay at banks, ATMs, or through online banking. Boleto requires a country-specific document field. Use the init payment API v1 required fields with specific:

  • payment_type_data.brazil_cpf

After a successful request, follow pay_form.return_url in the response to complete the payment flow.

CPF
52274278288
SUCCESS
success
CPF
213 630 678 26
INVALID CPF FORMAT
declined Contains spaces
CPF
052.161.533-0
INVALID CPF FORMAT
declined Too short

Efecty
anchor

Guide
Accept Efecty cash payments in Colombia with voucher-based checkout redeemable at thousands of physical collection points across the country. Efecty requires a country-specific document field. Use the init payment API v1 required fields with specific:

  • payment_type_data.colombia_cc

After a successful request, follow pay_form.return_url in the response to complete the payment flow.

Cedula de Ciudadania
42141221
SUCCESS
success

Mercado Pago
anchor

Guide
Accept Mercado Pago payments across Latin America with multi-method checkout supporting cards, wallets, and local payment options. Mercado Pago requires a country-specific document field. Use the init payment API v1 required fields with specific:

  • payment_type_data.brazil_cpf

After a successful request:

CPF
42141221
SUCCESS
success

OXXO
anchor

Guide
Accept OXXO cash voucher payments in Mexico with barcode-based checkout redeemable at over 20,000 convenience store locations nationwide. OXXO requires a country-specific document field in payment_type_data. Use the test init payment API v1 required fields with specific:

  • payment_type_data.mexico_curp

After a successful request, follow pay_form.return_url in the response to complete the payment flow.

CURP
GAMS871004HNERRM56
SUCCESS
success

PayPal
anchor

PayPal testing allows you to simulate failed transactions using a sandbox environment, which is useful for ensuring that your system correctly handles various scenarios, including negative flows.

Technical declines generated in the sandbox environment do not appear in PayPal's administrative dashboards.

  • Before you begin testing, ensure that your development environment is set up correctly.
  • To perform testing, contact us to request access to the PayPal sandbox account.

To test failed payments, set the API request with currency to USD and an amount, which should be specified in cents (for example, an amount of 302 means 3.02), to trigger errors.

AMOUNT
302
ERROR 3.02
error : {code: Guide
The customer's card balance has insufficient funds. 3.02 , message: "Insufficient funds"}
AMOUNT
305
ERROR 3.05
error : {code: Guide
The cardholder should contact their bank for further information. 3.05 , message: "Call your bank"}
AMOUNT
308
ERROR 3.08
error : {code: Guide
A general decline response indicating that the card issuer has rejected the transaction without providing a specific reason code. 3.08 , message: "Do not honor"}
AMOUNT
301
ERROR 3.01
error : {code: Guide
The card issuer bank blocked the card for payments. 3.01 , message: "Card is blocked"}
AMOUNT
302
ERROR 3.02
error : {code: Guide
The customer's card balance has insufficient funds. 3.02 , message: "Insufficient funds"}
AMOUNT
305
ERROR 3.05
error : {code: Guide
The cardholder should contact their bank for further information. 3.05 , message: "Call your bank"}
AMOUNT
308
ERROR 3.08
error : {code: Guide
A general decline response indicating that the card issuer has rejected the transaction without providing a specific reason code. 3.08 , message: "Do not honor"}
AMOUNT
502
ERROR 5.02
error : {code: Guide
An invalid or nonexistent card token was received during the transaction. 5.02 , message: "Invalid card token"}
AMOUNT
512
ERROR 5.12
error : {code: Guide
The account is blocked and all transactions made through this account are likely to be declined by the payment processor or acquiring bank until the problem is resolved. 5.12 , message: "Account is blocked"}

Pix
anchor

Guide
Accept SmartPix one-time and recurring payments in Brazil through Open Finance-powered direct bank connections with real-time settlement. SmartPix and Guide
Accept Pix instant payments in Brazil with QR-code-based checkout, real-time fund transfers, and Central Bank-regulated settlement. Pix require a country-specific document field. Use the init payment API v1 required fields with specific:

  • payment_type_data.brazil_cpf
CPF
01063207185
SUCCESS
success
CPF
52274278288
ERROR IN ACQUIRER
declined
Validation error
Missing customer.first_name or customer.last_name
Missing billing_address.country

Przelewy24
anchor

Guide
Integrate Przelewy24 to let Polish customers pay via online bank transfer with broad bank coverage and real-time payment verification. Przelewy24 is a Polish online bank transfer method supporting multiple banks, including BLIK as a sub-method. Use the init payment API v1 to initiate a payment.

After a successful request, follow pay_form.return_url in the response to complete the payment flow.

Select any bank on the sandbox page and approve the payment.
SUCCESS
success
AMOUNT
1002
PENDING
pending
Validation currency not supported
Currency other than PLN

PSE
anchor

Guide
Accept PSE bank transfer payments in Colombia by redirecting customers to their online banking portal for secure, real-time fund transfers. PSE requires a country-specific document field. Use the init payment API v1 required fields with specific:

  • payment_type_data.colombia_cc

After a successful request, follow pay_form.return_url in the response to complete the payment flow.

Cedula de Ciudadania
42141221
SUCCESS
success

Sencillito
anchor

Guide
Accept Sencillito cash payments in Chile with voucher-based checkout redeemable at physical collection points across the Chilean market. Sencillito requires a country-specific document field. Use the init payment API v1 required fields with specific:

  • payment_type_data.chile_ci

After a successful request, follow pay_form.return_url in the response to complete the payment flow.

CI number (identity card)
5633554V
SUCCESS
success

Servipag
anchor

Guide
Accept Servipag payments in Chile with flexible cash and bank transfer options through an established nationwide payment collection network. Servipag requires a country-specific document field. Use the init payment API v1 required fields with specific:

  • payment_type_data.chile_ci

After a successful request, follow pay_form.return_url in the response to complete the payment flow.

CI number (identity card)
5633554V
SUCCESS
success

Webpay
anchor

Guide
Integrate Webpay to process Chilean card payments through Transbank's dominant national payment gateway with broad card network support. Webpay requires a country-specific document field. Use the init payment API v1 required fields with specific:

  • payment_type_data.chile_ci

After a successful request, follow pay_form.return_url in the response to complete the payment flow.

CI number (identity card)
5633554
SUCCESS
success
Looking for help? Contact us
Stay informed with Changelog