Requests

Pay

The Pay action is the default action for the Twint Service. With this action a new transaction will be initiated.

Pay Requests

Example Pay Request:

{
   "Invoice":"Twint_Test_{{#buck_timestamp}}",
   "Description":"Test",
   "Currency":"CHF",
   "AmountDebit":1.00,
    "ReturnURL": "https://www.buckaroo.nl",
    "ReturnURLCancel": "https://www.buckaroo.nl/annuleren",
    "ReturnURLError": "https://www.buckaroo.nl/mislukt",
    "ReturnURLReject": "https://www.buckaroo.nl/geweigerd",
   "Services":{
      "ServiceList":[
         {
            "Name":"Twint",
            "Action":"Pay",
            "Parameters":[
            ]
         }
      ]
   }
}

Pay Response

Example Pay Response:

{
    "Key": "AE8F7BF37E4C41BEBA83827E8AFA0707",
    "Status": {
        "Code": {
            "Code": 791,
            "Description": "Pending processing"
        },
        "SubCode": {
            "Code": "S002",
            "Description": "An additional action is required: Redirect to Twint."
        },
        "DateTime": "2025-09-02T11:06:44"
    },
    "RequiredAction": {
        "RedirectURL": "https://testcheckout.buckaroo.nl/html/redirect.ashx?r=EDEB61182C2C4B31A769FAA1166B67F3",
        "RequestedInformation": null,
        "PayRemainderDetails": null,
        "Name": "Redirect",
        "TypeDeprecated": 0
    },
    "Services": null,
    "CustomParameters": null,
    "AdditionalParameters": null,
    "RequestErrors": null,
    "Invoice": "Twint_Test_1756804002",
    "ServiceCode": "twint",
    "IsTest": true,
    "Currency": "CHF",
    "AmountDebit": 1.0,
    "TransactionType": "C405",
    "MutationType": 1,
    "RelatedTransactions": null,
    "ConsumerMessage": null,
    "Order": null,
    "IssuingCountry": null,
    "StartRecurrent": false,
    "Recurring": false,
    "CustomerName": null,
    "PayerHash": null,
    "PaymentKey": "CB8EA305A91845D495EF5196005DF785"
}

Pay Push

Example Push:

{
    "Transaction": {
        "Key": "AE8F7BF37E4C41BEBA83827E8AFA0707 ",
        "Invoice": "Testinvoice 123",
        "ServiceCode": "Twint",
        "Status": {
            "Code": {
                "Code": 190,
                "Description": "Success"
            },
            "SubCode": {
                "Code": "S990",
                "Description": "The request was successful."
            },
            "DateTime": "2025-09-02T10:27:34"
        },
        "IsTest": true,
        "Order": null,
        "Currency": "CHF",
        "AmountDebit": 1.0,
        "TransactionType": " C405",
        "Services": null,
        "CustomParameters": null,
        "AdditionalParameters": null,
        "MutationType": 1,
        "RelatedTransactions": null,
        "IsCancelable": false,
        "IssuingCountry": null,
        "StartRecurrent": false,
        "Recurring": false,
        "PayerHash": null,
        "PaymentKey": "CB8EA305A91845D495EF5196005DF785"
    }
}

Refund Request

Example Refund Request:

{
    "Currency": "EUR",
    "AmountCredit": 1.0,
    "Invoice": "testinvoice 123",
    "OriginalTransactionKey": "948547CF2D8E456ABF3E84A948D62DAA",
    "Services": {
        "ServiceList": [
            {
                "Name": "Twint",
                "Action": "Refund"
            }
        ]
    }
}

Refund Response

Example Refund Response:

{
    "Key": " A5119DE5DE0144AF9EC99D886269123",
    "Status": {
        "Code": {
            "Code": 190,
            "Description": "Success"
        },
        "SubCode": {
            "Code": "S990",
            "Description": "The request was successful."
        },
        "DateTime": "2020-01-08T16:05:56"
    },
    "RequiredAction": null,
    "Services": null,
    "CustomParameters": null,
    "AdditionalParameters": null,
    "RequestErrors": null,
    "Invoice": "testinvoice 123",
    "ServiceCode": " Twint",
    "IsTest": true,
    "Currency": "CHF",
    "AmountCredit": 1.0,
    "TransactionType": "C406",
    "MutationType": 1,
    "RelatedTransactions": [
        {
            "RelationType": "refund",
            "RelatedTransactionKey": "948547CF2D8E456ABF3E84A948D62DAA "
        }
    ],
    "ConsumerMessage": null,
    "Order": null,
    "IssuingCountry": null,
    "StartRecurrent": false,
    "Recurring": false,
    "CustomerName": null,
    "PayerHash": null,
    "PaymentKey": "4090E8741FE44442A09096D64E29345"
}

Refund Push

Example Push:

{
    "Transaction": {
        "Key": "A5119DE5DE0144AF9EC99D886269123",
        "Invoice": "testinvoice 123",
        "ServiceCode": "Twint",
        "Status": {
            "Code": {
                "Code": 190,
                "Description": "Success"
            },
            "SubCode": null,
            "DateTime": "2020-01-08T16:05:56"
        },
        "IsTest": true,
        "Order": null,
        "Currency": "CHF",
        "AmountCredit": 1.0,
        "TransactionType": "C406",
        "Services": null,
        "CustomParameters": null,
        "AdditionalParameters": null,
        "MutationType": 1,
        "RelatedTransactions": [
            {
                "RelationType": "refund",
                "RelatedTransactionKey": "948547CF2D8E456ABF3E84A948D62DAA"
            }
        ],
        "IsCancelable": false,
        "IssuingCountry": null,
        "StartRecurrent": false,
        "Recurring": false,
        "CustomerName": null,
        "PayerHash": null,
        "PaymentKey": null
    }
}