Requests

Requests


Pay

Performing this action will create an order at 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.

Base JSON request

Use the base request as instructed on this page

Pay request

Parameters

Service specific parameters

Parameter Type Required Recommended Description
PaymentMethod string Required Which flow is used at Tinka. Possible values: "Credit", Invoiced", "ZeroPercent24Months", "ZeroPercentCredit", "Invoice", "FashionLoan", "PayIn3". Needs to be agreed in advance with Tinka. Default is "Credit"
DeliveryMethod string Required The delivery method used. The following values are supported: "CompanyDelivery", "Locker", "ParcelStation", "Parcelshop", "CompanyStore", "ShippingPartner"
DeliveryDate datetime Delivery date for the order
Quantity string Required GroupType: Article. Article quantity
Type decimal GroupType: Article. Article type. Possible values: 0 - Unknown, 1 - Article, 2 - GiftCard, 3 - Discount
UnitGrossPrice decimal Required GroupType: Article. Article price including VAT.
UnitCode string Required GroupType: Article. Article code
Description string Required GroupType: Article. Article description
Brand string GroupType: Article. Article brand
Manufacturer string GroupType: Article. Article manufacturer
Color string GroupType: Article. Article color
Email string Required GroupType: BillingCustomer. Email address of billing customer
Phone string GroupType: BillingCustomer. Phone number of billing customer
PrefixLastName string GroupType: BillingCustomer. Prefix of the billing last name
Street string Required GroupType: BillingCustomer. Street of billing customer
StreetNumber string Required GroupType: BillingCustomer. House number of billing customer
StreetNumberAdditional string GroupType: BillingCustomer. House suffix of billing address
City string Required GroupType: BillingCustomer. City of billing customer
PostalCode string Required GroupType: BillingCustomer. Postal code of billing customer
Country string GroupType: BillingCustomer. Country of billing customer
ExternalName string GroupType: ShippingCustomer. External name of shipping customer
Street string Required GroupType: ShippingCustomer. Street of shipping customer
StreetNumber string Required GroupType: ShippingCustomer. House number of shipping customer
StreetNumberSuffix string GroupType: ShippingCustomer. House number suffix of shipping customer
PostalCode string Required GroupType: ShippingCustomer. Postal code of shipping customer
City string Required GroupType: ShippingCustomer. City of shipping customer
Country string GroupType: ShippingCustomer. Country of shipping customer
FirstName string Customer first name
LastName string Customer last name
Initials string Customer initials
DateOfBirth datetime Customer date of birth
Gender string Customer gender. Use 1 for male, 2 for female, 0 for unknown
Basic parameters

Example request

{
  "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
}

Pay 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.

Parameters

Basic parameters

Example response

{
  "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"
}

Pay push

Parameters

Basic parameters

Example push

{
   "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.

Base JSON request

Use the base request as instructed on this page

Refund request

Parameters

Service specific parameters

Parameter Type Required Recommended Description
OriginalTransactionKey string Required This is a basic parameter. Transaction key of the original transaction
Basic parameters

Example request

{
  "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
}

Refund response

Parameters

Basic parameters

Example response

{
  "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"
}

Refund push

Parameters

Service specific parameters

Parameter Type Required Recommended Description
Basic parameters

Example push

{
   "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
   }
}

Was this article helpful?

What's Next