Integration Flow

curl -X POST https://api.getivy.de/api/service/order/create \
  -H "X-Ivy-Api-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": 1.23,
    "currency": "EUR",
    "referenceId": "your-internal-reference",
    "customer": {
      "email": "customer@example.com"
    }
  }'

    import express from 'express';
    import Ivy from '@getivy/node-sdk';
    import { OrderCreateParams } from '@getivy/node-sdk/resources/order';

    const router = express.Router();
    const ivy = new Ivy('YOUR_API_KEY');

    router.post('/your-server-endpoint', async (req, res) => {
      try {
        const params: OrderCreateParams = {
          amount: req.body.amount, // Required, in decimals e.g. 1.23 for 1.23 EUR
          currency: req.body.currency || 'EUR', // Required, currency of the amount
          referenceId: req.body.referenceId, // Required, your internal reference for this order
          customer: {
            email: req.body.customer?.email // Optional, email of the customer
          },
          expiresAt: req.body.expiresAt, // Optional, defaults to 6 days from now
        };

        const order = await ivy.order.create(params);
        res.json(order.destination); // The destination to which the customer should transfer the money
      } catch (error) {
        console.error("Failed to create order", error);
        res.status(400).json({ error: 'Failed to create order' });
      }
    });

    export default router;

<?php
$apiKey = 'YOUR_API_KEY';
$url = 'https://api.getivy.de/api/service/order/create';

$data = [
    'amount' => 1.23,
    'currency' => 'EUR',
    'referenceId' => 'your-internal-reference',
    'customer' => [
        'email' => 'customer@example.com'
    ]
];

$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data));
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'X-Ivy-Api-Key: ' . $apiKey,
    'Content-Type: application/json'
]);

$response = curl_exec($ch);
curl_close($ch);

$result = json_decode($response, true);

{
  "destination": {
    "bankAccount": {
      "iban": {
        "iban": "DE12345678901234567890",
        "accountHolderName": "John Doe",
        "bic": "DEUTDEDB615"
      }
    },
    "bankStatementReference": "irf1234556679"
  }
}

{
  "destination": {
    "bankAccount": {
      "sortCode": {
        "sortCode": "123456",
        "accountNumber": "1234567890",
        "accountHolderName": "John Doe"
      }
    },
    "bankStatementReference": "irf1234556679"
  }
}