API gift card per rivenditori e negozi online. Oltre 30.000 prodotti, senza magazzino.
Un’unica API REST per gift card digitali, carte gaming, chiavi di gioco e valute di gioco. Il tuo negozio mostra il nostro catalogo a prezzi all’ingrosso, il cliente paga te, e il tuo server riceve il codice in meno di un secondo.
- 30.000+prodotti
- 100+paesi
- <1 sconsegna tipica
- 2015sul mercato dal
curl -X POST https://api.cdkeymarkt.com/v1/orders \
-H "Authorization: Bearer $CDKM_API_KEY" \
-H "Idempotency-Key: shop-100482-1" \
-d '{"reference":"SHOP-100482","currency":"EUR",
"items":[{"product_id":"prd_8kq2v7m1","quantity":1,
"max_unit_price":"19.50"}]}'order = requests.post(
"https://api.cdkeymarkt.com/v1/orders",
headers={"Authorization": f"Bearer {KEY}",
"Idempotency-Key": "shop-100482-1"},
json={"reference": "SHOP-100482", "currency": "EUR",
"items": [{"product_id": "prd_8kq2v7m1",
"quantity": 1, "max_unit_price": "19.50"}]},
timeout=30,
).json()$ch = curl_init('https://api.cdkeymarkt.com/v1/orders');
curl_setopt_array($ch, [
CURLOPT_POST => true,
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => [
'Authorization: Bearer ' . getenv('CDKM_API_KEY'),
'Content-Type: application/json',
'Idempotency-Key: shop-100482-1',
],
CURLOPT_POSTFIELDS => json_encode([
'reference' => 'SHOP-100482', 'currency' => 'EUR',
'items' => [['product_id' => 'prd_8kq2v7m1',
'quantity' => 1, 'max_unit_price' => '19.50']],
]),
]);
$order = json_decode(curl_exec($ch), true);const order = await fetch("https://api.cdkeymarkt.com/v1/orders", {
method: "POST",
headers: { Authorization: `Bearer ${KEY}`,
"Content-Type": "application/json",
"Idempotency-Key": "shop-100482-1" },
body: JSON.stringify({ reference: "SHOP-100482", currency: "EUR",
items: [{ product_id: "prd_8kq2v7m1", quantity: 1,
max_unit_price: "19.50" }] }),
}).then((r) => r.json());{
"id": "ord_3n7xk2p9q4",
"status": "completed",
"total": "19.12",
"items": [{
"name": "Steam Wallet Gift Card 20 EUR",
"codes": [{ "code": "8XK4Q-2M7PD-L9VRT" }]
}]
}Chi usa l’API
Negozi online
Rivenditori
App e bot
Fedeltà e premi
Cosa fa l’API gift card
Tutto quello che serve a un negozio per vendere codici digitali che non ha in magazzino.
Catalogo gift card
Ordini
Ricariche per ID giocatore
Webhook
Sandbox
Saldi
Dalla richiesta al primo ordine
Un referente dedicato ti segue in ogni passaggio.
- Invia una richiesta
Compila il modulo e passa una breve verifica della tua azienda (KYB). Lavoriamo solo con aziende verificate.
- Ricevi l’accesso alla sandbox
Ricevi le chiavi di test e la documentazione completa dell’API per i tuoi sviluppatori.
- Collega e testa
Configura catalogo, ordini e webhook. Gli ordini di prova li rivediamo insieme a te.
- Vai in produzione
Attiviamo le chiavi di produzione per gli IP dei tuoi server. Ricarica il saldo e inizia a vendere.
L’API gift card in breve
REST e JSON su HTTPS, autenticazione con chiave, paginazione a cursore, orari in UTC, importi come stringhe. La documentazione completa va ai partner dopo l’onboarding.
/productsCatalogo con prezzi, regioni e disponibilità/products/{id}Un prodotto: prezzo e disponibilità in questo momento/ordersEffettuare un ordine e ricevere i codici/orders/{id}Stato dell’ordine e codici consegnati/top-ups/validateVerificare un ID giocatore prima della ricarica/balanceSaldo per valuta/transactionsEstratto di addebiti e rimborsiCosa puoi vendere
Domande frequenti
Devo comprare magazzino per usare l’API gift card?
No. Il tuo negozio mostra il nostro catalogo e ci invia l’ordine solo dopo che il cliente ha pagato. Ogni ordine viene addebitato sul tuo saldo prepagato.
È un’API gift card per rivenditori?
Sì. L’API è pensata per rivenditori, negozi online, app e piattaforme di premi che vendono o distribuiscono gift card digitali e chiavi di gioco. Hai prezzi all’ingrosso e un catalogo di oltre 30.000 prodotti.
Dove trovo la documentazione completa dell’API?
La documentazione completa, l’accesso alla sandbox e l’aiuto con l’integrazione vanno ai partner dopo l’onboarding e la verifica dell’azienda.
Quali piattaforme posso collegare?
Qualsiasi cosa possa inviare richieste HTTPS da un server: WooCommerce, Shopify, Magento, negozi su misura, bot Telegram e strumenti interni.
In quanto tempo arriva il codice?
Di solito direttamente nella risposta all’ordine, in meno di un secondo. Se la consegna richiede più tempo, l’ordine si completa in background e inviamo un webhook.
C’è una sandbox?
Sì. Ha un saldo di prova, una copia del catalogo e prodotti speciali per testare ritardi, consegne parziali ed esaurimento scorte.
Posso comprare all’ingrosso senza l’API?
Sì. Il portale B2B ha lo stesso catalogo e gli stessi prezzi. Lì ordini un lotto a mano e scarichi i codici.