Hosted Checkout

Server einrichten

const apiUrl = process.env.TAPAYA_CHECKOUT_API_URL;
const apiKey = process.env.TAPAYA_CHECKOUT_API_KEY;

async function checkoutRequest(path, options = {}) {
	const response = await fetch(new URL(path, apiUrl), {
		...options,
		headers: {
			...options.headers,
			Authorization: `Bearer ${apiKey}`,
		},
		redirect: 'error',
		cache: 'no-store',
		signal: AbortSignal.timeout(8000),
	});

	if (!response.ok) {
		throw new Error(`Checkout request failed (${response.status})`);
	}

	return response.json();
}

Session erstellen

Berechnen Sie den Gesamtbetrag der Bestellung auf Ihrem Server, einschließlich Steuern und Versand. Speichern Sie die Bestellung und einen eindeutigen checkoutAttemptKey, bevor Sie die Anfrage stellen, und laden Sie order aus diesem gespeicherten Snapshot. merchantOrderId ist erforderlich.

const session = await checkoutRequest('/merchant/checkout-sessions', {
	method: 'POST',
	headers: {
		'Content-Type': 'application/json',
		'Idempotency-Key': order.checkoutAttemptKey,
	},
	body: JSON.stringify({
		merchantOrderId: order.id,
		amount: order.totalInMinorUnits,
		currency: order.currency,
		successUrl: 'https://shop.example/checkout/return',
		cancelUrl: 'https://shop.example/checkout/cancel',
	}),
});

Die Antwort enthält die id der Session und die gehostete url. Positionsübersichten, Steueraufschlüsselungen, Kundendaten und alle Felder der Antwort beschreibt Checkout-Session erstellen.

Wenn die Anfrage fehlschlägt oder in ein Timeout läuft, wiederholen Sie sie mit demselben Schlüssel und unverändertem Body. Erzeugen Sie für ein unsicheres Ergebnis nie einen neuen Schlüssel: Ein geänderter Body mit demselben Schlüssel gibt HTTP 409 zurück.

Kunden weiterleiten

Speichern Sie session.id mit Ihrer Bestellung als deren checkoutSessionId und leiten Sie den Browser dann mit HTTP 303 auf session.url weiter. Verwenden Sie die URL unverändert, statt sie selbst zusammenzusetzen.

// First persist session.id as the order's checkoutSessionId.
return Response.redirect(session.url, 303);

Wenn Ihr Framework eine andere API für Antworten verwendet, senden Sie HTTP 303 mit session.url im Header Location. Öffnen Sie bei cURL die zurückgegebene url in Ihrem Browser, um die Zahlung von Hand zu testen.

Zahlung verifizieren

Ermitteln Sie in Ihrem Rückkehr-Handler die Bestellung aus dem authentifizierten Checkout-Kontext Ihrer Anwendung und rufen Sie ihre gespeicherte Session von Ihrem Server ab. Tun Sie dies auch bei der Abbruch-URL: Ein Aufruf einer der beiden URLs beweist nichts.

const current = await checkoutRequest(
	`/merchant/checkout-sessions/${encodeURIComponent(order.checkoutSessionId)}`,
);

if (
	current.id !== order.checkoutSessionId ||
	current.merchantOrderId !== order.id ||
	current.amount !== order.totalInMinorUnits ||
	current.currency !== order.currency
) {
	throw new Error('Checkout session does not match the order');
}

const paid = current.paymentStatus === 'successful';