Wat je kunt ontvangen
Gebruik Ethereum-mainnet. Geverifieerde ERC-20-tokens zoals USDC en USDT hebben ETH op elk verzendadres nodig wanneer je ze later verplaatst. Herstelzinnen importeren in MetaMask toont mogelijk alleen het eerste account.
Stel je winkel in
- Installeer Wholly Crypto, maak een project en winkel aan en bewaar een privéwalletback-up.
- Controleer scannercompatibele verbindingen en schakel de blockchain en gewenste activa in via Winkel → Betaalmethoden.
- Stel bevestigingen en verloop in. Test een kleine factuur en controleer of die is voldaan voordat je bestellingen afhandelt.
Waar je betalingen aankomen
Elke factuur krijgt een nieuw ontvangstadres. Je back-up dekt de afgeleide sleutels, maar herstelwoorden importeren in MetaMask toont mogelijk alleen het eerste account. Bewaar ook de adres- en afleidingsgegevens.
Handleiding voor walletinstellingenVerplaats middelen wanneer je er klaar voor bent
Gebruik automatische sweeps om ontvangsten naar één bestemming te brengen. Elk adres met tokens heeft ETH nodig om te verzenden. Door het project gefinancierd gas kan geschikte adressen binnen je limieten voorzien; lege onbetaalde factuuradressen worden niet gefinancierd.
Handleiding voor automatische sweepsKan ik USDT en USDC op hetzelfde adres ontvangen?
De wallet kan beide houden, maar elke factuur heeft eigen betaalmethoden en een eigen bedrag. Schakel de exacte Ethereum-contracten in de winkel in. Vervang ze niet door een token met dezelfde ticker van een ander netwerk.
Betalingsproblemen oplossen
Controleer eerst dit netwerk
Controleer Ethereum-mainnet en het exacte tokencontract. Een tokensaldo kan zijn eigen gas niet betalen: elk verzendadres heeft ETH op Ethereum nodig.
Een betaling ontbreekt of is vertraagd
Vergelijk het netwerk, adres, activum en eventuele vereiste referentie met de factuur. Controleer scannergereedheid en bevestigingsvoortgang. Vraag niet om een tweede betaling voordat je de eerste transactie hebt gecontroleerd.
OntvangsthandleidingWallets herstellen of samenvoegen
Bewaar je privéback-up en afleidingsgegevens. Een andere wallet-app toont mogelijk niet elk ontvangstadres. Verzenden en herstellen hangen af van de blockchain en het walletformaat; alleen herstelwoorden importeren garandeert geen van beide.
Back-up & herstelKosten en verificatie
De standaardverwerkingskosten zijn 1% van de fiatwaarde van de factuur, betaald uit afzonderlijk tegoed. Je toegewezen tarief is van toepassing. Netwerkkosten en serverkosten staan hier los van.
Openbare providers kunnen storingen of snelheidslimieten hebben. Een ingediende transactie of terugkeerdoorverwijzing is geen betalingsbewijs. Gebruik de geverifieerde factuurstatus en ondertekende meldingen.
Verwerkingstegoed API, IPN & webhooksKoerscalculator
Een bedrag omrekenen
Een schatting, geen prijsopgave voor een betaling. Netwerkkosten, beurskosten en handelaarsopslagen zijn niet inbegrepen.
Waar komen de koersen vandaan?
Cryptoschattingen gebruiken gecachte publieke Kraken-prijzen, aangevuld met Binance waar beschikbaar. Sommige Binance-prijzen gebruiken USDT als USD-referentie. Fiatkoersen komen van Frankfurter en zijn dagelijkse referentiekoersen, geen live handelskoersen.
De momentopname wordt automatisch vernieuwd. Controleer de brondatums onder je resultaat. Het ingevoerde bedrag blijft in je browser. Een vermelding van een actief garandeert geen betaalondersteuning.
Kraken · Binance · Frankfurter · Namen & pictogrammen van activa: CoinGecko
Maak een factuur aan met de API
Voer deze voorbeelden op je server uit. Vervang de API-host, het project-ID en winkel-ID en houd de referentie geheim. Bedragen zijn decimale tekenreeksen.
Schakel de methode eerst in de winkel in. Selectie beperkt ingeschakelde methoden; ze voegt geen activa toe. Als niets overeenkomt, gelden de winkelstandaarden. Controleer de geretourneerde methoden voordat je de afrekenpagina toont.
: "${WHOLLY_TOKEN:?Set WHOLLY_TOKEN to your server-side API token}"
# Keep this key and the exact body for retries; use a new key for each new invoice.
curl --fail-with-body --max-time 30 \
--request POST \
--url "https://api.example.com/v1/projects/YOUR_PROJECT_ID/stores/YOUR_STORE_ID/invoices" \
--header "Authorization: Bearer $WHOLLY_TOKEN" \
--header 'Idempotency-Key: order-1042-attempt-1' \
--header 'Content-Type: application/json' \
--data-raw '{
"amount": "25.00",
"currency": "EUR",
"order_id": "order-1042",
"payment_methods": [
{
"chain_slug": "ethereum",
"asset_tickers": [
"ETH"
]
}
]
}'// Node.js 18+ · run on your server, never in browser code.
const token = process.env.WHOLLY_TOKEN;
if (!token) throw new Error("Set WHOLLY_TOKEN");
// Keep this key and the exact body for retries; use a new key for each new invoice.
const body = `{
"amount": "25.00",
"currency": "EUR",
"order_id": "order-1042",
"payment_methods": [
{
"chain_slug": "ethereum",
"asset_tickers": [
"ETH"
]
}
]
}`;
const response = await fetch("https://api.example.com/v1/projects/YOUR_PROJECT_ID/stores/YOUR_STORE_ID/invoices", {
method: "POST",
headers: {
"Authorization": `Bearer ${token}`,
"Idempotency-Key": "order-1042-attempt-1",
"Content-Type": "application/json"
},
body,
redirect: "error",
signal: AbortSignal.timeout(30000)
});
if (!response.ok) throw new Error(`HTTP ${response.status}: ${await response.text()}`);
console.log(await response.json());<?php
// PHP 8+ with the cURL extension; run on your server.
$token = getenv('WHOLLY_TOKEN');
if (!$token) { throw new RuntimeException('Set WHOLLY_TOKEN'); }
// Keep this key and the exact body for retries; use a new key for each new invoice.
$body = <<<'JSON'
{
"amount": "25.00",
"currency": "EUR",
"order_id": "order-1042",
"payment_methods": [
{
"chain_slug": "ethereum",
"asset_tickers": [
"ETH"
]
}
]
}
JSON;
$ch = curl_init("https://api.example.com/v1/projects/YOUR_PROJECT_ID/stores/YOUR_STORE_ID/invoices");
curl_setopt_array($ch, [
CURLOPT_CUSTOMREQUEST => 'POST',
CURLOPT_RETURNTRANSFER => true,
CURLOPT_FOLLOWLOCATION => false,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTPHEADER => ['Authorization: Bearer ' . $token, "Idempotency-Key: order-1042-attempt-1", "Content-Type: application/json"],
CURLOPT_POSTFIELDS => $body,
]);
$response = curl_exec($ch);
$status = curl_getinfo($ch, CURLINFO_HTTP_CODE);
if ($response === false) { throw new RuntimeException(curl_error($ch)); }
curl_close($ch);
if ($status < 200 || $status >= 300) { throw new RuntimeException("HTTP $status: $response"); }
print_r(json_decode($response, true, 512, JSON_THROW_ON_ERROR));# Python 3 · standard library; run on your server.
import json
import os
from urllib.request import Request, build_opener, HTTPRedirectHandler
class NoRedirect(HTTPRedirectHandler):
def redirect_request(self, req, fp, code, msg, headers, newurl):
return None
# Keep this key and the exact body for retries; use a new key for each new invoice.
headers = {
"Idempotency-Key": "order-1042-attempt-1",
"Content-Type": "application/json"
}
headers["Authorization"] = "Bearer " + os.environ["WHOLLY_TOKEN"]
body = """{
"amount": "25.00",
"currency": "EUR",
"order_id": "order-1042",
"payment_methods": [
{
"chain_slug": "ethereum",
"asset_tickers": [
"ETH"
]
}
]
}""".encode("utf-8")
request = Request("https://api.example.com/v1/projects/YOUR_PROJECT_ID/stores/YOUR_STORE_ID/invoices",
method="POST", headers=headers, data=body)
# Non-2xx responses raise HTTPError. Do not retry writes with a new key.
with build_opener(NoRedirect()).open(request, timeout=30) as response:
print(json.load(response))