Create card transaction

Sandbox Cards (Non-3DS)

Card Number

Result

Decline code

Description

4000000000000002 

Success

/

Authorize or purchase transaction is successfuly created.

5555555555554444

Declined 

authorizationFailure

Authorization failure.

4008460000000000 

Declined 

cardExpired 

The card has expired.

4716160000000009 

Declined 

cardStolen 

The payment has been declined because the card is reported stolen.

Sandbox Card (3DS)

Card Number

Result

Decline code

Description

4111111111111111

Success

/

Redirect to 3DS simulator

Parameters

Parameter

Type

Required

Description

amount

number

Yes

Transaction Amount

currency

string

Yes

ISO 3 Currency Code

action

string

Yes

Enum: “Authorize”, “Purchase”

statementDescriptor

string <= 35

No

An optional billing descriptor displayed on the account owner’s statement

description

string <= 150

No (Yes for NNKCP**)

Transaction description

reference

string <= 40

No

Merchant reference

ipAddress

string <= 45 characters

Yes

Consumer’s IP Address

userDefinedField1 

string <= 100 characters 

No

No User defined field

userDefinedField2

string <= 100 characters 

No

No User defined field

userDefinedField3

string <= 100 characters 

No

No User defined field

successUrl

string <= 255 characters 

Yes

For redirect payment methods, this overrides the default success redirect URL configured on your account

cancelUrl

string <= 255 characters 

Yes

For redirect payment methods, this overrides the default cancel redirect URL configured on your account

failureUrl

string <= 255 characters 

Yes

For redirect payment methods, this overrides the default failure redirect URL configured on your account

“customer” object

firstName

string

Yes

First name

lastName

string

Yes

Last name

email

string

Yes

Email

phone

string

No

Phone number

accountReference

string

Yes

Account Reference

category

string

No

Account category

address

object

Yes

Customer Address 

“source” object

paymentMethod

string

Yes

example: “VISA”

holder

string

Yes

Account holder name and surname

cardNumber

string

Yes

Card number

expiryMonth

number

Yes

Card expiry month

expiryYear

number

Yes

Card expiry year

cvc

number

Yes

Card 3 digit CVC

billingAddress

object

Yes

Customer Address (including streetAddress, city, postcode, country & state)

Payment method: VISA, MASTERCARD

Request object

POST https://api.quaife.net/v1/transactions/

{
“amount”:10,
“currency”:”EUR”,
“action”:”Purchase”,
“customer”:{
“firstName”: “Max”,
“lastName”: “Muster”,
“email”: “max@example.com”,
“phone”: “+234323423”,
“accountReference”:”acc0002″,
“category”: “gaming”,
“address”: {
“streetAddress”:”3 Malpas Road”,
“city”: “Great Sutton”,
“postcode”:”CH65 7BQ”,
“country”:”GB”
}
},
“source”:{
“paymentMethod”: “VISA”,
“holder”: “Max Muster”,
“cardNumber”:”5101080000000009″,
“expiryMonth”: 12,
“expiryYear”: 20,
“cvc”: “123”,
“billingAddress”: {
“streetAddress”:”3 Malpas Road”,
“city”: “Great Sutton”,
“postcode”:”CH65 7BQ”,
“country”:”GB”
}
},
“statementDescriptor”:”Purchase my-shop.com”,
“Description”:”T-Shirt XXL”,
“Reference”:”ORD24234″,
“ipAddress”:”117.174.147.27″,
“successUrl”:”https://example.com/home/success”,
“cancelUrl”:”https://example.com/home”,
“failureUrl”:”https://example.com/home/cancel”
}

Response

{
“id”: “trn_lsbt1or4xy”,
“status”: “Pending”,
“amount”: 100.0,
“currency”: “EUR”,
“source”: {
“id”: “src_u8l7s06px5”,
“paymentMethod”: “VISA”,
“cardNumber”: “510108xxxxxx0009”,
“holder”: “Max Muster”
},
“customer”: {
“id”: “cus_wlydwqmn59”,
“firstName”: “Max”,
“lastName”: “Muster”,
“email”: “max@example.com”
},
“created”: “2020-12-18T15:24:13.8524886Z”,
“links”: [
{
“href”: “https://quaife.net/3d-transactions/allnl1ic9krs2smp6ywmcqwlard9o77dk107zpno”,
“rel”: “redirect”,
“method”: “GET”
}
],
“nextAction”: {
“type”: “RedirectToUrl”
}
}

MERCHANT

Should you be interested in becoming a merchant, then please fill out the short form below and one of our specialists will be in touch shortly.

SIGN UP

We are delighted that you are considering using Quaife as your payment partner. Fill in the form below & let’s get started.