Merchant API Integration Guide

curl --request POST   --url https://payinextra.com/api/v1/payments/deposits   --header 'Content-Type: application/json'   --header 'X-API-Key: YOUR_API_KEY'   --header 'X-Merchant-Id: YOUR_MERCHANT_ID'   --header 'X-Idempotency-Key: 550e8400-e29b-41d4-a716-446655440000'   --data '{
    "amount": 12550,
    "currency": "TRY",
    "paymentMethod": "bank_transfer",
    "merchantReference": "order-2026-000045",
    "customer": {
      "name": "Ahmet Yılmaz",
      "reference": "customer-1742",
      "email": "ahmet@example.com"
    },
    "metadata": {
      "cartId": "cart-8GQ39"
    }
  }'

const axios = require('axios');

async function createDeposit() {
  const res = await axios.post('https://payinextra.com/api/v1/payments/deposits', {
    amount: 12550, // 125.50 TRY (kuruş)
    currency: 'TRY',
    paymentMethod: 'bank_transfer',
    merchantReference: 'order-2026-000045',
    customer: {
      name: 'Ahmet Yılmaz',
      reference: 'customer-1742',
      email: 'ahmet@example.com'
    },
    metadata: {
      cartId: 'cart-8GQ39'
    }
  }, {
    headers: {
      'Content-Type': 'application/json',
      'X-API-Key': 'YOUR_API_KEY',
      'X-Merchant-Id': 'YOUR_MERCHANT_ID',
      'X-Idempotency-Key': '550e8400-e29b-41d4-a716-446655440000'
    }
  });

  console.log(res.data);
}
createDeposit();

post('https://payinextra.com/api/v1/payments/deposits', [
    'headers' => [
        'Content-Type' => 'application/json',
        'X-API-Key' => 'YOUR_API_KEY',
        'X-Merchant-Id' => 'YOUR_MERCHANT_ID',
        'X-Idempotency-Key' => '550e8400-e29b-41d4-a716-446655440000',
    ],
    'json' => [
        'amount' => 12550,
        'currency' => 'TRY',
        'paymentMethod' => 'bank_transfer',
        'merchantReference' => 'order-2026-000045',
        'customer' => [
            'name' => 'Ahmet Yılmaz',
            'reference' => 'customer-1742',
            'email' => 'ahmet@example.com'
        ],
        'metadata' => [
            'cartId' => 'cart-8GQ39'
        ]
    ]
]);

$data = json_decode($response->getBody(), true);
print_r($data);

import requests

url = "https://payinextra.com/api/v1/payments/deposits"
headers = {
    "Content-Type": "application/json",
    "X-API-Key": "YOUR_API_KEY",
    "X-Merchant-Id": "YOUR_MERCHANT_ID",
    "X-Idempotency-Key": "550e8400-e29b-41d4-a716-446655440000"
}
payload = {
    "amount": 12550,
    "currency": "TRY",
    "paymentMethod": "bank_transfer",
    "merchantReference": "order-2026-000045",
    "customer": {
        "name": "Ahmet Yılmaz",
        "email": "ahmet@example.com"
    }
}

res = requests.post(url, json=payload, headers=headers)
print(res.status_code, res.json())

{
  "paymentId": "pay_01H9YE1N5CB3X7S9HESY7Y5XGK",
  "type": "deposit",
  "status": "pending",
  "paymentMethod": "bank_transfer",
  "merchantReference": "order-2026-000045",
  "amount": 12550,
  "currency": "TRY",
  "paymentPageUrl": null,
  "metadata": {
    "selectedWallet": {
      "id": "pay_01H9YE1N5CB3X7S9HESY7Y5XGK",
      "iban": "TR120006200119000006672315",
      "accountName": "PAY-IN EXTRA TAHSILAT",
      "bankName": "Ornek Banka"
    }
  },
  "expiresAt": "2026-07-25T15:30:00.000Z"
}

{
  "paymentId": "pay_01H9YE1N5CB3X7S9HESY7Y5XGK",
  "type": "deposit",
  "status": "pending",
  "paymentMethod": "credit_card",
  "merchantReference": "order-2026-000045",
  "amount": 12550,
  "currency": "TRY",
  "paymentPageUrl": "https://payinextra.com/pay/pay_01H9YE1N5CB3X7S9HESY7Y5XGK",
  "metadata": null,
  "expiresAt": "2026-07-25T15:30:00.000Z"
}