Create a Gateway

post https://api.pay-link.eu/v1.0/Gateway/

Query Params

instance

string

required

Your Paylink instance name

Form Data

amount

int32

required

Amount of payment in cents.

vatRate

float

VAT Rate Percentage

currency

string

required

Currency of payment (ISO code).

sku

string

Product stock keeping unit

purpose

string

The purpose of the payment.

successRedirectUrl

string

URL to redirect to after successful payment.

failedRedirectUrl

string

URL to redirect to after failed payment.

cancelRedirectUrl

string

URL to redirect to after manual cancellation by shopper.

basket

array

List of all products (incl. shipping costs). The sum of all product amounts must match the amount parameter above. Basket products contains name, description, quantity and amount (in cents).

basket

psp

array of int32s

List of PSPs to provide for payment. If empty all available PSPs are provied.

psp

array of strings

List of payment mean names to display

preAuthorization

boolean

Defaults to false

Whether charge payment manually at a later date (type authorization)

reservation

boolean

Whether charge payment manually at a later date (type reservation)

referenceId

string

An internal reference id used by your system.

fields

string

The contact data fields which should be stored along with payment

concardisOrderId

string

Only available for Concardis PSP and if the custom ORDERID option is activated in PSP settings in Payrexx administration. This ORDERID will be transferred to the Payengine.

skipResultPage

boolean

Skip result page and directly redirect to success or failed URL

chargeOnAuthorization

boolean

preAuthorization needs to be "true". This will charge the authorization during the first payment.

validity

int32

Gateway validity in minutes.

subscriptionState

boolean

Defines whether the payment should be handled as subscription.

subscriptionInterval

string

Payment interval

subscriptionPeriod

string

Duration of the subscription

subscriptionCancellationInterval

string

Defines the period, in which a subscription can be canceled.

buttonText

array of strings

Change the default button Text "Pay" to a custom String

buttonText

lookAndFeelProfile

string

UUID of the look and feel profile to use.

successMessage

string

Custom success message on result page.

Responses

Language

Request


xxxxxxxxxx
16
1
apiSignature=`echo -n "amount=8925&vatRate=7.7&currency=CHF&sku=P01122000&pm%5B0%5D=visa&preAuthorization=0&reservation=0&referenceId=975382&fields%5Bforename%5D%5Bvalue%5D=Max&fields%5Bsurname%5D%5Bvalue%5D=Mustermann&fields%5Bemail%5D%5Bvalue%5D=max.mustermann%40mysite.com&successRedirectUrl=https%3A%2F%2Fwww.merchant-website.com%2Fsuccess&failedRedirectUrl=https%3A%2F%2Fwww.merchant-website.com%2Ffailed" | openssl dgst -sha256 -hmac "INSTANCE_API_SECRET" -binary | openssl enc -base64`
2
curl --request POST "https://api.pay-link.eu/v1.0/Gateway/?instance=INSTANCE_NAME" \
3
  --data-urlencode "amount=8925" \
4
  --data-urlencode "vatRate=7.7" \
5
  --data-urlencode "currency=CHF" \
6
  --data-urlencode "sku=P01122000" \
7
  --data-urlencode "pm[0]=visa" \
8
  --data-urlencode "preAuthorization=0" \
9
  --data-urlencode "reservation=0" \
10
  --data-urlencode "referenceId=975382" \
11
  --data-urlencode "fields[forename][value]=Max" \
12
  --data-urlencode "fields[surname][value]=Mustermann" \
13
  --data-urlencode "fields[email][value]=max.mustermann@mysite.com" \
14
  --data-urlencode "successRedirectUrl=https://www.merchant-website.com/success" \
15
  --data-urlencode "failedRedirectUrl=https://www.merchant-website.com/failed" \
16
  --data-urlencode "ApiSignature=$apiSignature"

Choose an example:

application/json

200200

201201