Payment Methods

Providers

Direct iDEAL

                                                            
{
   "id": "7bb6f1f3-d280-4b0c-a74f-90471ea69426", // Auto-generated UUID
   "paymentMethod": "ideal",
   "returnUrl": "http://example.com", // URL to return after payment completion.
   "webhookUrl": "https://example.com", // URL to receive webhook notification.
   "transaction":{
      "reference": "test-1111", // Max 20 characters
      "currency": "EUR", // ISO4217 format
      "amount": 2000, // The amount is in cents, 2000 = 20 EUR. Has to be sum of amounts * quantity in lines.
      "description": "test-1444",
      "lines":[
         {
            "name": "Some Voucher - 20 EUR", // Max 100 characters. Name of product.
            "category": "PREPAID-VOUCHER", // Max 100 characters.
            "brand": "alphacomm", // Max 100 characters.
            "quantity": 1, // Number of items
            "amount": 2000 // The amount is in cents, 2000 = 20 EUR
         }
      ]
   },
   "ideal": {
      "issuerId": "RABONL2U"
   },
}
                                                            
                                                        

Direct iDEAL Sandbox - Banks

In direct iDEAL integration, we are using Rabobank as a sandbox for test payments so for issuerID RABONL2U has to be set. For production use, any of available banks can be used.
List with available ids can be viewed in call "api/v1/get-methods"

"ideal": {
   "issuerId": "RABONL2U"
},

for the list of issuerIDs contact Dev team.

For sandbox payments use next amounts in request to trigger specific response

  • 100 - Success
  • 200 - Canceled
  • 300 - Expired
  • 400 - Open
  • 500 - Fail
  • 600 - Success
  • 500 - Exception trigger: Fail

Merchant Configuration

  • privateKey - sha256 key generated and set in config in dashboard and bank
  • publicKey - sha256 key generated and set in config in dashboard and bank
  • certificate - sha256 key generated and set in config in dashboard and bank
  • acquirerUrl - Provided by bank provider
  • MerchantId - Set in iDEAL config on bank side
  • subId - Usually 0 unless defined in iDEAL as subset