iDEAL

iDEAL is a joined initiative from all the Dutch banks to provide an easy to use realtime guaranteed payment system for all account holders.

This section provides reference information about processing iDEAL payments with the CURO API.
Please check the Transactions for generic information applicable to all payment methods.
Please check the iDEAL Example for generic information applicable to all payment methods.

iDEAL Payment

After the consumer/customer has chosen iDEAL as a payment method, the merchant sends a transaction request to the API. A transaction is registered in the iDEAL system and the response will contain the redirection URL where the consumer can complete the transaction.

See Examples.

Entry point: /rest/v1/curo/payment/ideal/

REST request elements

See the iDEAL request parameters in the API reference.

REST response elements

See the iDEAL Payment response elements.

Examples

JSON example request

POST /rest/v1/curo/payment/ideal/ HTTP/1.1
Authorization: Basic dXNlcm5hbWU6YXBpa2V5
Host: secure.curopayments.net
Content-type: application/json
Accept: application/json

{
    "site_id": "1234",
    "currency_id": "EUR",
    "amount": 100,
    "reference": "Reference 1",
    "description": "Description 1",
    "url_success": "http://www.example.com/ok.html",
    "url_pending": "http://www.example.com/pending.html",
    "url_failure": "http://www.example.com/wrong.html",
    "url_callback": "http://www.example.com/callback.html",
    "country_id": "NL",
    "language_id": "nl",
    "ip": "1.2.3.4",
    "consumer": {
        "firstname": "John",
        "lastname": "Doe",
        "email": "[email protected]",
        "address": "Nowhereroad 12",
        "city": "NonVille",
        "zipcode": "12345",
        "country_id": "NL",
        "phone": "0612345678",
        "dob": "10-07-1970",
        "gender": "m"
    },
    "cartitems": [
        {
            "quantity": 1,
            "sku": "spijkers_01",
            "name": "Spijkers",
            "price": 150,
            "vat": 21,
            "vat_inc": true,
            "type": 1
        },
        {
            "quantity": 1,
            "sku": "Discount",
            "name": "Discount total",
            "price": -50,
            "vat": 21,
            "vat_inc": true,
            "type": 4
        }
    ]
}

JSON response for correct request

HTTP/1.1 200 OK
Content-Type: application/json

{
    "payment": {
        "action": "redirect",
        "transaction_id": "T1234567890",
        "url": "https://betalen.rabobank.nl/ideal-betaling/landingpage?random=cb1b38473e30f816f871928e5d1eeaf596f6869e82ba27417b528995da6b8423&trxid=0050002306563522"
    },
    "success": true
}

JSON response for incomplete request

HTTP/1.1 200 OK
Content-Type: application/json

{
    "payment": {
        "action": "redirect",
        "external": "false",
        "url": "https://secure.curopayments.net/v1/payment/idealpro.app?transaction=T1234567890",
        "transaction_id": "T1234567890"
    },
    "success": true
}

iDEAL Refund

See the generic Refund information and request elements.

iDEAL Recurring

When the initial iDEAL transaction was registered with the option recurring enabled, subsequent recurring payments can be created using the account information available.

Recurring payments for iDEAL are processed via SEPA Direct Debit (SDD). See the generic Recurring (SDD) information and request elements.