CDKeyMarkt
Catalogo
API
Blog
Lavora con noi
CDKeyMarkt API · v1

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"}]}'
201 Created
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.

  1. Invia una richiesta

    Compila il modulo e passa una breve verifica della tua azienda (KYB). Lavoriamo solo con aziende verificate.

  2. Ricevi l’accesso alla sandbox

    Ricevi le chiavi di test e la documentazione completa dell’API per i tuoi sviluppatori.

  3. Collega e testa

    Configura catalogo, ordini e webhook. Gli ordini di prova li rivediamo insieme a te.

  4. Vai in produzione

    Attiviamo le chiavi di produzione per gli IP dei tuoi server. Ricarica il saldo e inizia a vendere.

Richiedi l’accesso API

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.

URL di base
https://api.cdkeymarkt.com/v1
Sandbox
https://sandbox.api.cdkeymarkt.com/v1
Auth
Bearer ck_live_…
GET/productsCatalogo con prezzi, regioni e disponibilità
GET/products/{id}Un prodotto: prezzo e disponibilità in questo momento
POST/ordersEffettuare un ordine e ricevere i codici
GET/orders/{id}Stato dell’ordine e codici consegnati
POST/top-ups/validateVerificare un ID giocatore prima della ricarica
GET/balanceSaldo per valuta
GET/transactionsEstratto di addebiti e rimborsi

Cosa 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.