Transaction (POST)

Transaction (POST)


POST json/Transaction

Creates a new transaction in the Buckaroo Payment Engine

The authentication of this JSON API is based on a standard HMAC Authentication implementation.

Request information

URI parameters

None.

Body Parameters

TransactionRequest

Name Type Description
Currency string None
AmountDebit decimal number None
AmountCredit decimal number None
Invoice string None
Order string None
Description string None
ClientIP IPAddress None
ReturnURL string None
ReturnURLCancel string None
ReturnURLError string None
ReturnURLReject string None
OriginalTransactionKey string None
StartRecurrent boolean None
ContinueOnIncomplete ContinueOnIncomplete None
ServicesSelectableByClient string None
ServicesExcludedForClient string None
PushURL string None
PushURLFailure string None
ClientUserAgent string None
OriginalTransactionReference TransactionReference None
Services ServicesRequest None
CustomParameters CustomParameters None
AdditionalParameters TransactionRequestAdditionalParameters None.

Request Formats

Sample:

{
  "Currency": "EUR",
  "AmountDebit": 1.0,
  "AmountCredit": 1.0,
  "Invoice": "Test Invoice 1234",
  "Order": "sample string 3",
  "Description": "Example for docs",
  "ClientIP": {
    "Type": 0,
    "Address": "192.168.2.1"
  },
  "ReturnURL": "https://www.buckaroo.nl/return",
  "ReturnURLCancel": "https://www.buckaroo.nl/returncancel",
  "ReturnURLError": "https://www.buckaroo.nl/returnerror",
  "ReturnURLReject": "https://www.buckaroo.nl/returnreject",
  "OriginalTransactionKey": "sample string 9",
  "StartRecurrent": true,
  "ContinueOnIncomplete": 0,
  "ServicesSelectableByClient": "ideal,mastercard,visa,giftcard",
  "ServicesExcludedForClient": "payconiq,nexi",
  "PushURL": "https://www.buckaroo.nl/push",
  "PushURLFailure": "https://www.buckaroo.nl/pushfail",
  "ClientUserAgent": "sample string 17",
  "OriginalTransactionReference": {
    "Type": "sample string 1",
    "Reference": "sample string 2"
  },
  "Services": {
    "ServiceList": [
      {
        "Name": "sample string 1",
        "Action": "sample string 2",
        "Version": 3,
        "Parameters": [
          {
            "Name": "sample string 1",
            "GroupType": "sample string 2",
            "GroupID": "sample string 3",
            "Value": "sample string 4"
          },
          {
            "Name": "sample string 1",
            "GroupType": "sample string 2",
            "GroupID": "sample string 3",
            "Value": "sample string 4"
          }
        ]
      },
      {
        "Name": "sample string 1",
        "Action": "sample string 2",
        "Version": 3,
        "Parameters": [
          {
            "Name": "sample string 1",
            "GroupType": "sample string 2",
            "GroupID": "sample string 3",
            "Value": "sample string 4"
          },
          {
            "Name": "sample string 1",
            "GroupType": "sample string 2",
            "GroupID": "sample string 3",
            "Value": "sample string 4"
          }
        ]
      }
    ]
  },
  "CustomParameters": {
    "List": [
      {
        "Name": "sample string 1",
        "Value": "sample string 2"
      },
      {
        "Name": "sample string 1",
        "Value": "sample string 2"
      }
    ]
  },
  "AdditionalParameters": {
    "AdditionalParameter": [
      {
        "Name": "sample string 1",
        "Value": "sample string 2"
      },
      {
        "Name": "sample string 1",
        "Value": "sample string 2"
      }
    ]
  }
}

Response Information

Name Type Description
Key string None.
Status Status None.
RequiredAction TransactionRequestResponseRequiredAction None.
Services Collection of TransactionRequestResponseServiceResponse None.
CustomParameters CustomParameters None.
AdditionalParameters TransactionRequestAdditionalParameters None.
RequestErrors TransactionRequestResponseRequestErrors None.
Invoice string None.
ServiceCode string None.
IsTest boolean None.
Currency string None.
AmountDebit decimal number None.
AmountCredit decimal number None.
TransactionType string None.
MutationType MutationType None.
RelatedTransactions Collection of RelatedTransaction None.
ConsumerMessage TransactionRequestResponseConsumerMessage None.
Order string None.
IssuingCountry string None.
StartRecurrent boolean None.
Recurring boolean None.
CustomerName string None.
PayerHash string None.
PaymentKey string None.

Response Formats

application/json, text/json
Sample:

{
  "Key": "4E8BD922192746C3918BF4077CXXXXXX",
  "Status": {
    "Code": {
      "Code": 1,
      "Description": "sample string 2"
    },
    "SubCode": {
      "Code": "sample string 1",
      "Description": "sample string 2"
    },
    "DateTime": "2022-02-09T10:30:36.0795641+01:00"
  },
  "RequiredAction": {
    "RedirectURL": "sample string 1",
    "RequestedInformation": [
      {
        "Name": "sample string 1",
        "DataType": 0,
        "MaxLength": 2,
        "Required": true,
        "Description": "sample string 4"
      },
      {
        "Name": "sample string 1",
        "DataType": 0,
        "MaxLength": 2,
        "Required": true,
        "Description": "sample string 4"
      }
    ],
    "PayRemainderDetails": {
      "RemainderAmount": 1.0,
      "Currency": "sample string 2",
      "GroupTransaction": "sample string 3"
    },
    "Name": "Redirect",
    "TypeDeprecated": 0
  },
  "Services": [
    {
      "Name": "sample string 1",
      "Action": "sample string 2",
      "Parameters": [
        {
          "Name": "sample string 1",
          "Value": "sample string 2"
        },
        {
          "Name": "sample string 1",
          "Value": "sample string 2"
        }
      ],
      "VersionAsProperty": 1
    },
    {
      "Name": "sample string 1",
      "Action": "sample string 2",
      "Parameters": [
        {
          "Name": "sample string 1",
          "Value": "sample string 2"
        },
        {
          "Name": "sample string 1",
          "Value": "sample string 2"
        }
      ],
      "VersionAsProperty": 1
    }
  ],
  "CustomParameters": {
    "List": [
      {
        "Name": "sample string 1",
        "Value": "sample string 2"
      },
      {
        "Name": "sample string 1",
        "Value": "sample string 2"
      }
    ]
  },
  "AdditionalParameters": {
    "AdditionalParameter": [
      {
        "Name": "sample string 1",
        "Value": "sample string 2"
      },
      {
        "Name": "sample string 1",
        "Value": "sample string 2"
      }
    ]
  },
  "RequestErrors": {
    "ChannelErrors": [
      {
        "Service": "sample string 1",
        "Action": "sample string 2",
        "Name": "sample string 3",
        "Error": "sample string 4",
        "ErrorMessage": "sample string 5"
      },
      {
        "Service": "sample string 1",
        "Action": "sample string 2",
        "Name": "sample string 3",
        "Error": "sample string 4",
        "ErrorMessage": "sample string 5"
      }
    ],
    "ServiceErrors": [
      {
        "Name": "sample string 1",
        "Error": "sample string 2",
        "ErrorMessage": "sample string 3"
      },
      {
        "Name": "sample string 1",
        "Error": "sample string 2",
        "ErrorMessage": "sample string 3"
      }
    ],
    "ActionErrors": [
      {
        "Service": "sample string 1",
        "Name": "sample string 2",
        "Error": "sample string 3",
        "ErrorMessage": "sample string 4"
      },
      {
        "Service": "sample string 1",
        "Name": "sample string 2",
        "Error": "sample string 3",
        "ErrorMessage": "sample string 4"
      }
    ],
    "ParameterErrors": [
      {
        "Service": "sample string 1",
        "Action": "sample string 2",
        "Name": "sample string 3",
        "Error": "sample string 4",
        "ErrorMessage": "sample string 5"
      },
      {
        "Service": "sample string 1",
        "Action": "sample string 2",
        "Name": "sample string 3",
        "Error": "sample string 4",
        "ErrorMessage": "sample string 5"
      }
    ],
    "CustomParameterErrors": [
      {
        "Name": "sample string 1",
        "Error": "sample string 2",
        "ErrorMessage": "sample string 3"
      },
      {
        "Name": "sample string 1",
        "Error": "sample string 2",
        "ErrorMessage": "sample string 3"
      }
    ]
  },
  "Invoice": "sample string 2",
  "ServiceCode": "sample string 3",
  "IsTest": true,
  "Currency": "sample string 5",
  "AmountDebit": 1.0,
  "AmountCredit": 1.0,
  "TransactionType": "sample string 6",
  "MutationType": 0,
  "RelatedTransactions": [
    {
      "RelationType": "sample string 1",
      "RelatedTransactionKey": "sample string 2"
    },
    {
      "RelationType": "sample string 1",
      "RelatedTransactionKey": "sample string 2"
    }
  ],
  "ConsumerMessage": {
    "MustRead": true,
    "CultureName": "sample string 2",
    "Title": "sample string 3",
    "PlainText": "sample string 4",
    "HtmlText": "sample string 5"
  },
  "Order": "sample string 7",
  "IssuingCountry": "NL",
  "StartRecurrent": true,
  "Recurring": true,
  "CustomerName": "sample string 11",
  "PayerHash": "sample string 12",
  "PaymentKey": "sample string 13"
}

Was this article helpful?