TR Console
← Finance

Turkish FAST / TR Karekod Payload

Builds a person-to-person TR Karekod (FAST) payment payload from IBAN, name and optional TRY amount. Text only — no PNG.

POST /v1/tr/pay/qr · 1 credit · deterministic

  • No account needed to try any endpoint on this page.
  • Deterministic endpoints answer from cache in single-digit milliseconds.
  • Every response carries a receipt: credits charged, cache status, duration.

Free try on this page → when you need a key, pay to unlock full access.

POST/v1/tr/pay/qr
Request
{
  "iban": "TR33 0006 1005 1978 6457 8413 26",
  "name": "Ali Yilmaz"
}
no request sent yet
Response
Press Run to try free from your browser — no key needed. Next: Ödemeye geç · API erişimi.
1endpoints
data points banked
time series
median response

Why this exists

Built for hostile input

A Turkish address arrives as "Cd." or "Cad." or "Caddesi", with the flat number glued to the building number. Generic parsers drop half of it silently. This one tells you what it could not place.

Every number carries its provenance

Each archived point stores the source URL and a content hash of the page it came from, and the archive is committed to a Merkle root anchored in Bitcoin. Every commitment — with its cutoff, leaf count and anchors — is published at /proof, so you can check for yourself how current the latest one is. The bulletins themselves are public and anyone can read them; what this adds is that a number you quote can be shown to be the number we held on that date, and that it has not been edited since.

You only pay for work

Repeated inputs come from cache and cost zero credits. If a response ever fails its own schema, the call is refunded automatically.

Endpointsexpand any row to see the parameters and call it live

Finance1

/v1/tr/pay/qr Turkish FAST / TR Karekod Payload deterministic 1 credit

Builds a person-to-person TR Karekod (FAST) payment payload from IBAN, name and optional TRY amount. Text only — no PNG.

Turkish instant payments (FAST) can start from a TR Karekod that encodes the payee IBAN and name in EMV-style TLV. This builds the person-to-person organisation (payload format indicator 750210): application template with IBAN, payee name, optional 12-digit kuruş amount, optional free-text explanation, and a CRC-16/CCITT-FALSE trailer. The Turkish IBAN is normalised and checked with ISO 7064 mod-97; non-TR IBANs and non-TRY currencies are rejected. This does not send money and does not render a QR image.

Parameters

iban* string Beneficiary Turkish IBAN (with or without spaces).
name* string Payee name shown to the payer (2–26 chars after trim).
amount number TRY amount; omitted → static QR (payer enters amount).
explanation string Optional remittance note (application free field 10).
currency string Must be TRY if provided.
generatorCode string QR generator / EFT code (4 digits). Defaults to last 4 of the IBAN bank code.
POST/v1/tr/pay/qr
Request
{
  "iban": "TR33 0006 1005 1978 6457 8413 26",
  "name": "Ali Yilmaz"
}
no request sent yet
Response
Press Run to try free from your browser — no key needed. Next: Ödemeye geç · API erişimi.

Pricingone key covers every endpoint

Free try on this page → when you need a key, pay to unlock full access.

Credits are consumed per call and cache hits are free. Requests without a key run on a narrow per-IP demo quota so you can evaluate before signing up.

The API key is e-mailed the moment payment clears. Upgrades keep the same key, so your integration is never broken.

Want to finish the integration before paying?

Use it from an AI assistantthe same catalogue, exposed as MCP tools

Every endpoint is also published over the Model Context Protocol, so Claude, ChatGPT or your own agent can call it directly — no glue code, no wrapper functions. The assistant sees the same input schemas and the same metering.

Currently 37 tools. New endpoints appear automatically; nothing to update on your side.

claude_desktop_config.json

{
  "mcpServers": {
    "temsor": {
      "url": "https://api.temsor.com/mcp",
      "headers": { "x-api-key": "fk_live_…" }
    }
  }
}

Quickstart

Official client: npm install temsor-api · npmjs.com/package/temsor-api

Node.js

import Client from "temsor-api";

const api = new Client({ apiKey: KEY });
const r = await api.${(() => {
  const first = apis[0];
  return first.slug.split(/[/-]/).map((p, i) => (i === 0 ? p : p[0].toUpperCase() + p.slice(1))).join('');
})()}(${esc(JSON.stringify(apis[0].examples[0]?.input ?? {}))});
console.log(r, r.$meta);

cURL

curl -s https://api.temsor.com/v1/tr/pay/qr \
  -H "content-type: application/json" \
  -H "x-api-key: fk_live_…" \
  -d '{"iban":"TR33 0006 1005 1978 6457 8413 26","name":"Ali Yilmaz"}'

JavaScript

const res = await fetch("https://api.temsor.com/v1/tr/pay/qr", {
  method: "POST",
  headers: { "content-type": "application/json", "x-api-key": KEY },
  body: JSON.stringify({"iban":"TR33 0006 1005 1978 6457 8413 26","name":"Ali Yilmaz"})
});
const { data } = await res.json();

Python

import httpx
r = httpx.post("https://api.temsor.com/v1/tr/pay/qr",
    headers={"x-api-key": KEY},
    json={"iban":"TR33 0006 1005 1978 6457 8413 26","name":"Ali Yilmaz"})
data = r.json()["data"]
temsor API

Small, precise APIs behind one key and one response envelope. New endpoints ship on the same key.

References OpenAPI 3.1MCP manifestService health
Response contract

{ ok, data, meta }

{ ok:false, error }

Tell us what broke

Wrong answer, missing field, an endpoint you wish existed — it reaches a person, not a queue.