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. Currently Tinka is only available in The Netherlands (please keep that in mind for the parameter "country".
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", ZeroPercentCredit", "ZeroPercent24Months", "ZeroPercent36Months", "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 | ||
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 |
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
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
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.
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 |
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
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 |
---|
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
}
}