Pre-Authorization - Credit cards

post

https://pay4.sandbox.payabl.com/pay/backoffice/payment_preauthorize

A request to the Pre-Authorization interface will verify the credit card data, credit line, and reserve the requested funds.
Later the Payment Capture interface can be called to credit the reserved funds.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

❗️
Signature field
If you modify the parameter value you need to re-calculate the signature for the new parameters set. Use the signature calculation guide and secret b185.

Form Data

merchantid

string

required

Defaults to gateway_test

40 characters. The merchant identification number issued during account creation.

orderid

string

Defaults to api-test-123

max. 40 characters. The field orderid is optional and exclusively for the merchants convenience.

amount

double

required

Defaults to 1.23

8.2 / 8 digits. The amount field contains the transaction’s total amount. This is the amount that will be transmitted to the authorizing system.

currency

string

required

Defaults to EUR

3 characters. The currency field contains the alphanumeric currency code for the transaction, according to ISO 4217, e.g. EUR, USD, AUD, CAD, NOK, SEK, CHF. to http://www.xe.com/iso4217.php

payment_method

int32

required

Defaults to 1

Valid payment method id, e.g. 1 = Credit Card

signature

string

required

40 characters. The signature field contains a 40-figure hexadecimal value. This signature value is a checksum designed to protect the merchant account from unauthorized access.

ccn

string

Defaults to 4242424242424242

max. 16 digits. The ccn field contains the customer's credit card number. The payment gateway is capable of processing any credit card type.

exp_month

string

Defaults to 12

2 digits. Expiry month

exp_year

string

Defaults to 2020

4 digits. Expiry year

cvc_code

string

Defaults to 123

max. 4 digits. Security code of the credit card

cardholder_name

string

required

max. 50 characters. Card holder name

recurring_id

string

max. 10 characters. The recurring_id field required, if you want to send recurring transactions. Therefore the first transaction needs to be classified with INIT

language

string

Defaults to en

2 characters. The language in which the error messages will be displayed. Default value en or de. ISO-639-1 alpha 2

notification_url

string

255 characters. This parameter can be used to override the account notification url setup on our system.

string

required

Defaults to [email protected]

max. 50 characters. A RFC 822 compliant email address

external_id

string

255 characters. Merchant's unique id

salutation

string

max. 10 characters. Salutation. Mr., Mrs.

title

string

max. 20 characters. Title. Dr., Prof.

gender

string

1 character. Gender. M – male F – female

customerip

string

required

max. 39 characters. Customer IP

firstname

string

required

max. 30 characters. First name of the customer

lastname

string

required

max. 30 characters. Last name of the customer

birthday

string

8 digits. Birthday

street

string

required

max. 100 characters. Street of the customer's address.

house

string

max. 10 characters. The house number of the customer.

postbox

string

max. 20 characters. Post office box

zip

string

required

max. 10 characters. The customer's postal code

city

string

max. 40 characters. The customer's city

state

string

required

max. 30 characters. The state/province (USA and Canada only)

country

string

3 characters. The country of customer. ISO 3166 alpha3 format only

phone

string

max. 20 characters, only numbers. The customer's phone number

fax

string

max. 20 characters. The customer's fax number

mobile

string

max. 20 characters. The mobile number of the customer

company

string

max. 40 characters. The company

custom1

string

max. 255 characters. The custom field for the merchant

custom2

string

max. 255 characters. The custom field for the merchant

custom3

string

max. 255 characters. The custom field for the merchant

shop_url

string

max 255 characters starting with http or https. Used for dynamic 3Ds values (when enabled)

shipping_state

string

max 3 characters, ISO 3166-2

shipping_city

string

max 50 characters

shipping_address_line_1

string

max 50 characters

shipping_address_line_2

string

max 50 characters

shipping_postal_code

string

max 16 characters

shipping_first_name

string

max 150 characters

shipping_last_name

string

max 150 characters

billing_country_code

string

3 characters, ISO 3166-1

billing_state

string

max 3 characters, ISO 3166-2

billing_city

string

max 50 characters

billing_address_line_1

string

max 50 characters

billing_address_line_2

string

max 50 characters

billing_postal_code

string

max 16 characters

billing_first_name

string

max 150 characters

billing_last_name

string

max 150 characters

Responses

Pre-Authorization - Credit cards

Signature field

What’s Next

What’s Next

Signature field

200200

400400

What’s Next

What’s Next