Integration

In order to process a payment with Fast_Chekout, merchants must use as an action: PayFastCheckout and also they must not include Issuer in their requests, because that is not allowed with PayFastCheckout.

PayFastCheckout Request

{
  "Currency": "EUR",
  "AmountDebit": 0.01,
  "Invoice": "testinvoice 123",
  "Services": {
    "ServiceList": [
      {
        "Name": "ideal",
        "Action": "PayFastCheckout",
        "Parameters": []
      }
    ]
  }
}

PayFastCheckout Response

{
    "Key": "4E8BD922192746C3918BF4077CXXXXXX",
    "Status": {
        "Code": {
            "Code": 791,
            "Description": "Pending processing"
        },
        "SubCode": {
            "Code": "S002",
            "Description": "An additional action is required: RedirectToIdeal"
        },
        "DateTime": "2024-03-18T13:30:34"
    },
    "RequiredAction": {
        "RedirectURL": "https://testcheckout.buckaroo.nl/html/redirect.ashx?r=904A6432D283440ABD4418BF16XXXXXX",
        "RequestedInformation": null,
        "PayRemainderDetails": null,
        "Name": "Redirect",
        "TypeDeprecated": 0
    },
    "Services": [
        {
            "Name": "ideal",
            "Action": null,
            "Parameters": [
                {
                    "Name": "transactionId",
                    "Value": "0000000000000002"
                }
            ]
        }
    ],
    "CustomParameters": null,
    "AdditionalParameters": null,
    "RequestErrors": null,
    "Invoice": "testinvoice 123",
    "ServiceCode": "ideal",
    "IsTest": true,
    "Currency": "EUR",
    "AmountDebit": 0.01,
    "TransactionType": "C021",
    "MutationType": 1,
    "RelatedTransactions": null,
    "ConsumerMessage": null,
    "Order": null,
    "IssuingCountry": null,
    "StartRecurrent": false,
    "Recurring": false,
    "CustomerName": null,
    "PayerHash": null,
    "PaymentKey": "644545E2409D4223AC09E880ADXXXXXX"
}
}

PayFastCheckout Push

{
  "Transaction": {
    "Key": "4E8BD922192746C3918BF4077CXXXXXX",
    "Invoice": "testinvoice 123",
    "ServiceCode": "ideal",
    "Status": {
      "Code": {
        "Code": 190,
        "Description": "Success"
      },
      "SubCode": {
        "Code": "S001",
        "Description": "Transaction successfully processed"
      },
      "DateTime": "2017-03-28T11:24:14"
    },
    "IsTest": true,
    "Order": null,
    "Currency": "EUR",
    "AmountDebit": 10.0,
    "TransactionType": "C021",
    "Services": [
      {
        "Name": "ideal",
        "Action": null,
        "Parameters": [
          {
            "Name": "consumerIssuer",
            "Value": "ABN AMRO"
          },
          {
            "Name": "transactionId",
            "Value": "0000000000000001"
          },
          {
            "Name": "consumerName",
            "Value": "J. de Tèster"
          },
          {
            "Name": "consumerIBAN",
            "Value": "NL44RABO0123456789"
          },
          {
            "Name": "consumerBIC",
            "Value": "RABONL2U"
          },
          {
            "Name": "Description",
            "Value": "Dummy Description"
          },
          {
            "Name": "ContactDetailsFirstName",
            "Value": "John"
          },
	   {
            "Name": "ContactDetailsLastName",
            "Value": "Dijkstra"
          },
	  {
            "Name": "ContactDetailsPhoneNumber",
            "Value": "+31612345678"
          },
	  {
            "Name": "ContactDetailsEmail",
            "Value": "edsger@domain.nl"
          },
	  {
            "Name": "ShippingAddressFirstName",
            "Value": "Edsger W."
          },
	  {
            "Name": "ShippingAddressLastName",
            "Value": "Dijkstra"
          },
	  {
            "Name": "ShippingAddressCompanyName",
            "Value": "Cookie factory"
          },
	  {
            "Name": "ShippingAddressPostalCode",
            "Value": "3512NS"
          },
	  {
            "Name": "ShippingAddressAddition",
            "Value": "C"
          },
	  {
            "Name": "ShippingAddressHouseNumber",
            "Value": "100"
          },
  	  {
            "Name": "ShippingAddressStreet",
            "Value": "Bankastraat"
          },
  	  {
            "Name": "ShippingAddressCountryName",
            "Value": "Netherlands"
          },
  	  {
            "Name": "InvoiceAddressFirstName",
            "Value": "Edsger W."
          },
  	  {
            "Name": "InvoiceAddressLastName",
            "Value": "Dijkstra”
          },
  	  {
            "Name": "InvoiceAddressCompanyName",
            "Value": "Cookie factory”
          },
  	  {
            "Name": "InvoiceAddressPostalCode",
            "Value": "123ZZ”
          },
  	  {
            "Name": "InvoiceAddressAddition",
            "Value": "C”
          },
  	  {
            "Name": "InvoiceAddressHouseNumber",
            "Value": "100”
          },
  	  {
            "Name": "InvoiceAddressStreet",
            "Value": "Bankastraat”
          },
  	  {
            "Name": "InvoiceAddressCity",
            "Value": "Amsterdam”
          },
  	  
	  {
            "Name": "InvoiceAddressCountryName",
            "Value": "Netherlands”
          },
        ],
        "VersionAsProperty": 2
      }
    ],
    "CustomParameters": null,
    "AdditionalParameters": null,
    "MutationType": 1,
    "RelatedTransactions": null,
    "IsCancelable": false,
    "IssuingCountry": null,
    "StartRecurrent": false,
    "Recurring": false,
    "CustomerName": "J. de Tèster",
    "PayerHash": "d2e447e9bd91d6e5b4507c2699f2dfa117c60e2e70a13854df4dad57aa54f26785f710b5c6022a9feaf8eace18125f5b1c6929a2ec9a4ff0e88182f9fe085ec3",
    "PaymentKey": "644545E2409D4223AC09E880ADXXXXXX"
  }
}

In Payment Plaza the following information will be displayed for PayFastCheckout Transaction Details:

• Contact Details – First Name
• Contact Details – Last Name
• Contact Details – Phone Number
• Contact Details – Email

• Shipping Address – First Name
• Shipping Address – Last Name
• Shipping Address – Company Name
• Shipping Address – Email
• Shipping Address – House Number
• Shipping Address – Addition
• Shipping Address – Street
• Shipping Address – City
• Shipping Address – Country
• Shipping Address – Postal Code

• Invoice Address – First Name
• Invoice Address – Last Name
• Invoice Address – Company Name
• Invoice Address – Email
• Invoice Address – House Number
• Invoice Address – Addition
• Invoice Address – Street
• Invoice Address – City
• Invoice Address – Country
• Invoice Address – Postal Code

User names received after successful Checkout transactions

Note that for a checkout transaction you may receive 4 different User names:
• debtor.name: This is the name of the Payer according to the name of the bank account used for payment (as provided by the Issuer). This is the name to be used when e.g. making a refund.
• contactDetails.firstName and contactDetails.lastName: This the name that the User has chosen when creating her iDEAL profile. When communicating to the User (e.g. for shipping status updates) this is the name you should use for addressing the User.
• shippingAddress.firstNameand shippingAddress.lastName : This is the name the User has chosen during a Checkout transaction as the addressee. This is the name to be used for shipping.
• invoiceAddress.firstName and invoiceAddress.lastName : This is the name the User has chosen during a Checkout transaction as the invoicee. This is the name to be used for invoicing.