Requests

      Requests


        Article Summary

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

        Base JSON request

        Use the base request as instructed on this page

        Pay request

        Parameters

        Service specific parameters

        ParameterTypeRequiredRecommendedDescription
        PaymentMethodstringRequiredWhich 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"
        DeliveryMethodstringRequiredThe delivery method used. The following values are supported: "CompanyDelivery", "Locker", "ParcelStation", "Parcelshop", "CompanyStore", "ShippingPartner"
        DeliveryDatedatetimeDelivery date for the order
        QuantitystringRequiredGroupType: Article. Article quantity
        TypedecimalGroupType: Article. Article type. Possible values: 0 - Unknown, 1 - Article, 2 - GiftCard, 3 - Discount
        UnitGrossPricedecimalRequiredGroupType: Article. Article price including VAT.
        UnitCodestringRequiredGroupType: Article. Article code
        DescriptionstringRequiredGroupType: Article. Article description
        BrandstringGroupType: Article. Article brand
        ManufacturerstringGroupType: Article. Article manufacturer
        ColorstringGroupType: Article. Article color
        EmailstringRequiredGroupType: BillingCustomer. Email address of billing customer
        PhonestringGroupType: BillingCustomer. Phone number of billing customer
        PrefixLastNamestringGroupType: BillingCustomer. Prefix of the billing last name
        StreetstringRequiredGroupType: BillingCustomer. Street of billing customer
        StreetNumberstringRequiredGroupType: BillingCustomer. House number of billing customer
        StreetNumberAdditionalstringGroupType: BillingCustomer. House suffix of billing address
        CitystringRequiredGroupType: BillingCustomer. City of billing customer
        PostalCodestringRequiredGroupType: BillingCustomer. Postal code of billing customer
        CountrystringGroupType: BillingCustomer. Country of billing customer
        ExternalNamestringGroupType: ShippingCustomer. External name of shipping customer
        StreetstringRequiredGroupType: ShippingCustomer. Street of shipping customer
        StreetNumberstringRequiredGroupType: ShippingCustomer. House number of shipping customer
        StreetNumberSuffixstringGroupType: ShippingCustomer. House number suffix of shipping customer
        PostalCodestringRequiredGroupType: ShippingCustomer. Postal code of shipping customer
        CitystringRequiredGroupType: ShippingCustomer. City of shipping customer
        CountrystringGroupType: ShippingCustomer. Country of shipping customer
        FirstNamestringCustomer first name
        LastNamestringCustomer last name
        InitialsstringCustomer initials
        DateOfBirthdatetimeCustomer date of birth
        GenderstringCustomer 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

        ParameterTypeRequiredRecommendedDescription
        OriginalTransactionKeystringRequiredThis 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

        ParameterTypeRequiredRecommendedDescription
        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