General

Tinka is the new consumer credit payment method known from Wehkamp. Tinka allows consumers to spread their payment over a longer period of time.

The following actions are available for Tinka: Pay, Refund

Pay

Performing this action will create an order Tinka. In case there is something wrong or missing in the request, this will already throw a validation error. If successful, it will return a redirectURL to Tinka. Here the consumer has to create an account, and agree with the monthly installments and interest rates.

View in playground

Request


JSON gateway request

Note: always make sure the AmountDebit equals the sum of the article amounts

PaymentMethod
Required

Which flow is used at Tinka. At the moment only the value "Credit" is supported

DeliveryMethod
Required

The delivery method used. The following values are supported: "CompanyDelivery", "Locker", "ParcelStation", "Parcelshop", "CompanyStore", "ShippingPartner"

DeliveryDate

Deliverydate for the order

Quantity
Required

GroupType: Article. Article quantity

Type

GroupType: Article. Article type

UnitGrossPrice
Required

GroupType: Article. Article price including VAT.

UnitCode
Required

GroupType: Article. Article code

Description
Required

GroupType: Article. Article description

Brand

GroupType: Article. Article brand

Manufacturer

GroupType: Article. Article manufacturer

Color

GroupType: Article. Article color

Email
Required

GroupType: BillingCustomer. Email address of billing customer

Phone

GroupType: BillingCustomer. Phone number of billing customer

PrefixLastName

GroupType: BillingCustomer. Prefix of the billing last name

Street
Required

GroupType: BillingCustomer. Street of billing customer

StreetNumber
Required

GroupType: BillingCustomer. House number of billing customer

StreetNumberAdditional

GroupType: BillingCustomer. House suffix of billing address

City
Required

GroupType: BillingCustomer. City of billing customer

PostalCode
Required

GroupType: BillingCustomer. Postal code of billing customer

Country

GroupType: BillingCustomer. Country of billing customer

ExternalName

GroupType: ShippingCustomer. External name of shipping customer

Street
Required

GroupType: ShippingCustomer. Street of shipping customer

StreetNumber
Required

GroupType: ShippingCustomer. House number of shipping customer

StreetNumberSuffix

GroupType: ShippingCustomer. House number suffix of shipping customer

PostalCode
Required

GroupType: ShippingCustomer. Postal code of shipping customer

City
Required

GroupType: ShippingCustomer. City of shipping customer

Country

GroupType: ShippingCustomer. Country of shipping customer

FirstName

Customer first name

LastName

Customer last name

Initials

Customer initials

DateOfBirth

Customer date of birth

Gender

Customer gender. Use 1 for male, 2 for female, 0 for unknown

JSON

copy
{
  "Currency": "EUR",
  "AmountDebit": 3.5,
  "Invoice": "Testinvoice 123",
  "Description": "Tinka Test 01",
  "Services": {
    "ServiceList": [
      {
        "Name": "Tinka",
        "Action": "Pay",
        "Parameters": [
          {
            "Name": "PaymentMethod",
            "GroupType": "",
            "GroupID": "",
            "Value": "Credit"
          },
          {
            "Name": "DeliveryMethod",
            "GroupType": "",
            "GroupID": "",
            "Value": "Locker"
          },
          {
            "Name": "DeliveryDate",
            "GroupType": "",
            "GroupID": "",
            "Value": "09-07-2020"
          },
          {
            "Name": "Quantity",
            "GroupType": "Article",
            "GroupID": "1",
            "Value": "1"
          },
          {
            "Name": "Type",
            "GroupType": "Article",
            "GroupID": "1",
            "Value": "1"
          },
          {
            "Name": "UnitGrossPrice",
            "GroupType": "Article",
            "GroupID": "1",
            "Value": "3.5"
          },
          {
            "Name": "UnitCode",
            "GroupType": "Article",
            "GroupID": "1",
            "Value": "test"
          },
          {
            "Name": "Description",
            "GroupType": "Article",
            "GroupID": "1",
            "Value": "Blue Toy Car"
          },
          {
            "Name": "Brand",
            "GroupType": "Article",
            "GroupID": "1",
            "Value": "Ford Focus"
          },
          {
            "Name": "Manufacturer",
            "GroupType": "Article",
            "GroupID": "1",
            "Value": "Ford"
          },
          {
            "Name": "Color",
            "GroupType": "Article",
            "GroupID": "1",
            "Value": "Blue"
          },
          {
            "Name": "Size",
            "GroupType": "Article",
            "GroupID": "1",
            "Value": "Small"
          },
          {
            "Name": "Email",
            "GroupType": "BillingCustomer",
            "GroupID": "",
            "Value": "billingcustomer@buckaroo.nl"
          },
          {
            "Name": "Phone",
            "GroupType": "BillingCustomer",
            "GroupID": "",
            "Value": "0612345678"
          },
          {
            "Name": "PrefixLastName",
            "GroupType": "BillingCustomer",
            "GroupID": "",
            "Value": "the"
          },
          {
            "Name": "City",
            "GroupType": "BillingCustomer",
            "GroupID": "",
            "Value": "Utrecht"
          },
          {
            "Name": "Country",
            "GroupType": "BillingCustomer",
            "GroupID": "",
            "Value": "NL"
          },
          {
            "Name": "PostalCode",
            "GroupType": "BillingCustomer",
            "GroupID": "",
            "Value": "4811EA"
          },
          {
            "Name": "Street",
            "GroupType": "BillingCustomer",
            "GroupID": "",
            "Value": "Zonnebaan"
          },
          {
            "Name": "StreetNumber",
            "GroupType": "BillingCustomer",
            "GroupID": "",
            "Value": "9"
          },
          {
            "Name": "StreetNumberAdditional",
            "GroupType": "BillingCustomer",
            "GroupID": "",
            "Value": "A"
          },
          {
            "Name": "ExternalName",
            "GroupType": "ShippingCustomer",
            "GroupID": "",
            "Value": "Test"
          },
          {
            "Name": "Street",
            "GroupType": "ShippingCustomer",
            "GroupID": "",
            "Value": "Zonnebaan"
          },
          {
            "Name": "StreetNumber",
            "GroupType": "ShippingCustomer",
            "GroupID": "",
            "Value": "9"
          },
          {
            "Name": "StreetNumberAdditional",
            "GroupType": "ShippingCustomer",
            "GroupID": "",
            "Value": "A"
          },
          {
            "Name": "PostalCode",
            "GroupType": "ShippingCustomer",
            "GroupID": "",
            "Value": "3542EA"
          },
          {
            "Name": "City",
            "GroupType": "ShippingCustomer",
            "GroupID": "",
            "Value": "Utrecht"
          },
          {
            "Name": "Country",
            "GroupType": "ShippingCustomer",
            "GroupID": "",
            "Value": "NL"
          },
          {
            "Name": "Phone",
            "GroupType": "ShippingCustomer",
            "GroupID": "",
            "Value": "0307115000"
          },
          {
            "Name": "FirstName",
            "GroupType": "",
            "GroupID": "",
            "Value": "Test"
          },
          {
            "Name": "LastName",
            "GroupType": "",
            "GroupID": "",
            "Value": "Tester"
          },
          {
            "Name": "Initials",
            "GroupType": "",
            "GroupID": "",
            "Value": "TT"
          },
          {
            "Name": "DateOfBirth",
            "GroupType": "",
            "GroupID": "",
            "Value": "01-01-1990"
          },
          {
            "Name": "Gender",
            "GroupType": "",
            "GroupID": "",
            "Value": "1"
          }
        ]
      }
    ]
  },
  "CustomParameters": null,
  "AdditionalParameters": null
}

Response


JSON gateway response

If the request has a valid structure and a valid signature, a transaction will be created in the Payment Engine and a response will be returned. In this case, an additional action is required before the transaction can be completed. The customer needs to be redirected to Tinka through the redirectUrl in order to create an account.

JSON

copy
{
  "Key": "D6C974A494F643C59A50D9XXXXXXXXXX",
  "Status": {
    "Code": {
      "Code": 791,
      "Description": "Pending processing"
    },
    "SubCode": {
      "Code": "S002",
      "Description": "An additional action is required: Redirect to Tinka."
    },
    "DateTime": "2020-07-29T13:06:59"
  },
  "RequiredAction": {
    "RedirectURL": "http://testcheckout.buckaroo.nl/html/redirect.ashx?r=763A6D58DBB843F1B95D07XXXXXXXXXX",
    "RequestedInformation": null,
    "PayRemainderDetails": null,
    "Name": "Redirect",
    "TypeDeprecated": 0
  },
  "Services": null,
  "CustomParameters": null,
  "AdditionalParameters": null,
  "RequestErrors": null,
  "Invoice": "Testinvoice 123",
  "ServiceCode": "Tinka",
  "IsTest": false,
  "Currency": "EUR",
  "AmountDebit": 3.5,
  "TransactionType": "C066",
  "MutationType": 1,
  "RelatedTransactions": null,
  "ConsumerMessage": null,
  "Order": null,
  "IssuingCountry": null,
  "StartRecurrent": false,
  "Recurring": false,
  "CustomerName": null,
  "PayerHash": null,
  "PaymentKey": "DF2EFCD279454F458E73CBXXXXXXXXXX"
}

Push


JSON push response

JSON

copy
{
   "Transaction":{
      "Key":"D6C974A494F643C59A50D9XXXXXXXXXX",
      "Invoice":"Testinvoice 123",
      "ServiceCode":"Tinka",
      "Status":{
         "Code":{
            "Code":190,
            "Description":"Success"
         },
         "SubCode":{
            "Code":"S990",
            "Description":"The request was successful."
         },
         "DateTime":"2020-07-29T13:08:42"
      },
      "IsTest":false,
      "Order":null,
      "Currency":"EUR",
      "AmountDebit":3.5,
      "TransactionType":"C066",
      "Services": null,
      "CustomParameters":null,
      "AdditionalParameters":null,
      "MutationType":1,
      "RelatedTransactions":null,
      "IsCancelable":false,
      "IssuingCountry":null,
      "StartRecurrent":false,
      "Recurring":false,
      "CustomerName":null,
      "PayerHash":null,
      "PaymentKey":"DF2EFCD279454F458E73CBXXXXXXXXXX"
   }
}

Refund

A Refund request can be performed on a successful Pay transaction. No article information is required in the request, the original transaction key of the pay request will suffice.

View in playground

Request


JSON gatway request

OriginalTransactionKey
Required

This is a basic parameter. Transaction key of the original transaction

JSON

copy
{
  "Currency": "EUR",
  "AmountDebit": null,
  "AmountCredit": 2.0,
  "Invoice": "Testinvoice 123",
  "Order": null,
  "Description": "Refund Tinka",
  "ClientIP": null,
  "ReturnURL": null,
  "ReturnURLCancel": null,
  "ReturnURLError": null,
  "ReturnURLReject": null,
  "OriginalTransactionKey": "D6C974A494F643C59A50D9XXXXXXXXXX",
  "ServicesSelectableByClient": null,
  "ServicesExcludedForClient": null,
  "PushURL": null,
  "PushURLFailure": null,
  "ClientUserAgent": null,
  "OriginalTransactionReference": null,
  "Services": {
    "ServiceList": [
      {
        "Name": "Tinka",
        "Action": "Refund",
        "Version": 0,
        "Parameters": []
      }
    ]
  },
  "CustomParameters": null,
  "AdditionalParameters": null
}

Response


JSON gateway response

JSON

copy
{
  "Key": "A327373316904326BDF37CXXXXXXXXXX",
  "Status": {
    "Code": {
      "Code": 190,
      "Description": "Success"
    },
    "SubCode": {
      "Code": "S990",
      "Description": "The request was successful."
    },
    "DateTime": "2020-07-22T16:29:47"
  },
  "RequiredAction": null,
  "Services": null,
  "CustomParameters": null,
  "AdditionalParameters": null,
  "RequestErrors": null,
  "Invoice": "Testinvoice 123",
  "ServiceCode": "Tinka",
  "IsTest": false,
  "Currency": "EUR",
  "AmountCredit": 2.0,
  "TransactionType": "C067",
  "MutationType": 1,
  "RelatedTransactions": null,
  "ConsumerMessage": null,
  "Order": null,
  "IssuingCountry": null,
  "StartRecurrent": false,
  "Recurring": false,
  "CustomerName": null,
  "PayerHash": null,
  "PaymentKey": "B580C1E2AD694873B11F53XXXXXXXXXX"
}

Push


JSON push response

JSON

copy
{
   "Transaction":{
      "Key":"A327373316904326BDF37CXXXXXXXXXX",
      "Invoice":"Testinvoice 123",
      "ServiceCode":"Tinka",
      "Status":{
         "Code":{
            "Code":190,
            "Description":"Success"
         },
         "SubCode":null,
         "DateTime":"2020-07-22T16:29:47"
      },
      "IsTest":false,
      "Order":null,
      "Currency":"EUR",
      "AmountCredit":2.0,
      "TransactionType":"C067",
      "Services":null,
      "CustomParameters":null,
      "AdditionalParameters":null,
      "MutationType":1,
      "RelatedTransactions":null,
      "IsCancelable":false,
      "IssuingCountry":null,
      "StartRecurrent":false,
      "Recurring":false,
      "CustomerName":null,
      "PayerHash":null,
      "PaymentKey":null
   }
}