Advanced methods

Examples for advanced payment methods, that require extra fields like `customer`.

This page contains ready-to-use JSON request body examples for various payment methods: Apple Pay, Google Pay, Open Banking, and credit card (CC) payments.

How It Works

All examples below are sent the same way as a regular order creation — a POST request to:

What's different from a regular order?

For alternative payment methods, you add extra fields: extraParams, customer, and/or card. The rest of the fields (amount, currency, successUrl, failUrl, etc.) remain the same as in a regular order creation.

Additional Fields for common order

Field	Type	Description
`extraParams`	string	Specifies payment method (`"APPLEPAY"`, `"googlepay"`, `"apple_pay"`, etc.)
`customer`	object	Buyer's data (email, phone, address, etc.)
`card`	object	Bank card details (number, CVV, expiry date)

Open Banking

Payment via bank transfer. Customer details including date of birth are required.

Customer fields

Field	Type	Description
`email`	string	Buyer's email
`birthday`	string	Date of birth (YYYY-MM-DD)
`firstName`	string	First name
`lastName`	string	Last name

All fields are required

Example request

{
  "amount": "10.99",
  "currency": "EUR",
  "successUrl": "https://success.com",
  "failUrl": "https://fail.com",
  "customer": {
    "email": "pay_to_me@pay.com",
    "birthday": "1999-12-12",
    "firstName": "Jane",
    "lastName": "Doe"
  }
}

Apple Pay / Google Pay (STD)

Standard Apple Pay or Google Pay integration. Full customer details including address are required.

Customer fields

Field	Type	Description
`email`	string	Buyer's email
`phone`	string	Phone number
`firstName`	string	First name
`lastName`	string	Last name
`country`	string	Country code (ISO 3166-1)
`city`	string	City
`state`	string	State / region
`postcode`	string	Postal code
`address`	string	Address

All fields are required

Example request

{
  "amount": "10.99",
  "currency": "EUR",
  "successUrl": "https://success.com",
  "failUrl": "https://fail.com",
  "extraParams": "APPLEPAY",
  "customer": {
    "email": "pay_to_me@pay.com",
    "phone": "1999999999",
    "firstName": "Jane",
    "lastName": "Doe",
    "country": "PT",
    "city": "Maia",
    "state": "Porto",
    "postcode": "4450",
    "address": "Adasd Asdeda"
  }
}

For Google Pay, use "extraParams": "GOOGLEPAY" instead of "APPLEPAY".

Apple Pay / Google Pay (LR)

Simplified integration — only the buyer's email is required.

Customer fields

Field	Type	Description
`email`	string	Buyer's email

All fields are required

Example request

{
  "amount": "10.99",
  "currency": "EUR",
  "successUrl": "https://success.com",
  "failUrl": "https://fail.com",
  "extraParams": "apple_pay",
  "customer": {
    "email": "pay_to_me@pay.com"
  }
}

For Google Pay, use "extraParams": "google_pay" instead of "apple_pay".

Credit Card Payment (CC FTD)

First-Time Deposit by card. Full card and customer details are required.

Card fields

Field	Type	Description
`cardholderName`	string	Cardholder's name
`cardNumber`	string	Card number
`cvv`	string	CVV code
`expiryDate`	string	Expiry date (MM/YY)

All fields are required

Customer fields

Field	Type	Description
`email`	string	Buyer's email
`phone`	string	Phone number
`firstName`	string	First name
`lastName`	string	Last name
`birthday`	string	Date of birth (YYYY-MM-DD)
`country`	string	Country code (ISO 3166-1)
`city`	string	City
`region`	string	State / region
`postcode`	string	Postal code
`address`	string	Address

All fields are required

Request example

{
  "amount": "10.99",
  "currency": "EUR",
  "successUrl": "https://success.com",
  "failUrl": "https://fail.com",
  "card": {
    "cardholderName": "Jonister Stefan",
    "cardNumber": "4444444444444444",
    "cvv": "228",
    "expiryDate": "12/26"
  },
  "customer": {
    "email": "pay_to_me@pay.com",
    "phone": "1999999999",
    "firstName": "Jane",
    "lastName": "Doe",
    "birthday": "2000-05-05",
    "country": "PT",
    "city": "Maia",
    "region": "Porto",
    "postcode": "4450",
    "address": "Adasd Asdeda"
  }
}

Credit Card Payment (STD CC)

Standard card payment with simplified data — only email is required.

Customer fields

Field	Type	Description
`email`	string	Buyer's email

All fields are required

Request example

{
  "amount": "10.99",
  "currency": "EUR",
  "successUrl": "https://success.com",
  "failUrl": "https://fail.com",
  "extraParams": "apple_pay",
  "customer": {
    "email": "pay_to_me@pay.com"
  }
}

Google Pay (Standalone)

Standalone Google Pay integration with the buyer's IP address.

Customer fields

Field	Type	Description
`email`	string	Buyer's email
`ip`	string	Buyer's IP address

All fields are required

Request example

{
  "amount": "10.99",
  "currency": "EUR",
  "successUrl": "https://success.com",
  "failUrl": "https://fail.com",
  "extraParams": "googlepay",
  "customer": {
    "email": "pay_to_me@pay.com",
    "ip": "8.8.8.8"
  }
}

Apple Pay (Standalone)

Standalone Apple Pay integration with the buyer's IP address.

Customer fields

Field	Type	Description
`email`	string	Buyer's email
`ip`	string	Buyer's IP address

All fields are required

Request example

{
  "amount": "10.99",
  "currency": "EUR",
  "successUrl": "https://success.com",
  "failUrl": "https://fail.com",
  "extraParams": "applepay",
  "customer": {
    "email": "pay_to_me@pay.com",
    "ip": "8.8.8.8"
  }
}

Advanced methods

On this page