Optional values at the end of the URL may be omitted and will be treated as null.

Required values may not be null.

The parameters have the following format:

Parameter

Type

Description

Example

Type

{type}

Required

Type of the transaction

sale

Enum: sale, refund, void

{currency}

Conditional

Currency as defined in ISO 4217. Required during a sale or refund, ignored
during a
void.

EUR

VARCHAR(3)

{amount}

Conditional

A strict positive decimal number with a . as decimal separator. Must have exact
decimal
numbers
as dictated by the currency. Required during a sale or refund, ignored during a
void.

12.34

VARCHAR(255)

{timestamp}

Optional

Transaction timestamp in milliseconds

1461765983000

VARCHAR(255)

{parent}

Conditional

Transaction id of parent, required in case of void type

80119063-CB48-485E-BA29-45076C300387

VARCHAR(255)

{mref}

Optional

Merchant reference description

My example reference

VARCHAR(20)

{email}

Optional

Customer receipt email

test@test.com

VARCHAR(255)

{callback}

Optional

Callback URL

myapp://www.myapp.be/callback/{status}

VARCHAR(512)

The transaction timestamp can be used to identify the transaction request and it prevents a transaction
from
being
started twice. You can also use it to perform a status check on a previously iniated transaction. If the
timestamp
is already found during transaction processing, it will not initiate a new transaction but it will still
trigger
the
callback URL if specified.

Some examples:

A sale payment of EUR 120.000,55:

ccvpay://www.ccvmini.be/sale/EUR/120000.55

A refund payment of EUR 120.000,55:

ccvpay://www.ccvmini.be/refund/EUR/120000.55

A void of a previous payment with transaction id 58. The currency has
been
filled
in but will be ignored and can be replaced with “null”: