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.
Request
JSON gateway request
Note: always make sure the AmountDebit equals the sum of the article amounts
|
PaymentMethod
string
|
Required
Which flow is used at Tinka. Possible values: "Credit", "ZeroPercent24Months". 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
|
Deliverydate 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 |
JSON
{
"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 200 Status: Ok 400 Status: Access denied 500 Status: Bad request
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
{
"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
{
"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.
Request
JSON gatway request
|
OriginalTransactionKey
string
|
Required
This is a basic parameter. Transaction key of the original transaction |
JSON
{
"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 200 Status: Ok 400 Status: Access denied 500 Status: Bad request
JSON gateway response
JSON
{
"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
{
"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
}
}