Create a Gateway

post https://api.annanow-pay.com/v1.0/Gateway/

Note for NodeJS: You need to install the following modules:
npm i axios crypto-js qs

📘
Using the PHP client library
If you are using our PHP client library, there are setter and getter methods to access the PHP object properties.

📘
Integration manual
For more information about the usage of Annanow Gateway, please visit Annanow Gateway section.

Query Params

instance

string

required

Your Annanow instance name

Form Data

amount

int32

required

Amount of payment in cents.

currency

string

required

Currency of payment (ISO code).

vatRate

float

Defaults to null

VAT Rate Percentage

sku

string

Product stock keeping unit

purpose

string

The purpose of the payment.

basket

array of strings

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

Defaults to false

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 Annanow administration. This ORDERID will be transferred to the Payengine.

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.

skipResultPage

boolean

Defaults to false

Skip result page and directly redirect to success or failed URL

chargeOnAuthorization

boolean

Defaults to false

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

validity

int32

Gateway validity in minutes.

subscriptionState

boolean

Defaults to false

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.

Response

xxxxxxxxxx
apiSignature=`echo -n "amount=8925&vatRate=7.7&currency=CHF&sku=P01122000&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`
curl --request POST "https://api.annanow-pay.com/v1.0/Gateway/?instance=INSTANCE_NAME" \
  --data-urlencode "amount=8925" \
  --data-urlencode "vatRate=7.7" \
  --data-urlencode "currency=CHF" \
  --data-urlencode "sku=P01122000" \
  --data-urlencode "preAuthorization=0" \
  --data-urlencode "reservation=0" \
  --data-urlencode "referenceId=975382" \
  --data-urlencode "fields[forename][value]=Max" \
  --data-urlencode "fields[surname][value]=Mustermann" \
  --data-urlencode "fields[email][value]=max.mustermann@mysite.com" \
  --data-urlencode "successRedirectUrl=https://www.merchant-website.com/success" \
  --data-urlencode "failedRedirectUrl=https://www.merchant-website.com/failed" \
  --data-urlencode "ApiSignature=$apiSignature"

Create a Gateway

📘
Using the PHP client library

📘
Integration manual

📘Using the PHP client library

📘Integration manual

200200

📘
Using the PHP client library

📘
Integration manual