Handle errors

# A failure answers its HTTP status and { error, code, details, requestId }: branch on the status# and the code, quote requestId to support. An order nobody paid yet is not an error here: the# page has no item.curl "https://api.qbitflow.app/v2/payments?reference=order-1042" \  -H "X-API-Key: $QBITFLOW_API_KEY"# 200: a page of Payment ({ items, hasMore }), items empty when nobody paid that order

try {	const payment = await client.payments.getByReference('order-1042');	console.log(`order-1042 paid: ${payment.amountUsd} USD`);} catch (err) {	if (err instanceof NotFoundError) {		console.log('no payment for order-1042 yet');	} else if (err instanceof ValidationError) {		// Refused before sending (status undefined) or by the API (400).		for (const f of err.fieldErrors) console.log(`${f.field}: ${f.message}`);	} else if (err instanceof ApiError) {		// Branch on status and code, never on the message. Quote requestId to support.		console.log(`QBitFlow error ${err.status} ${err.code} (request ${err.requestId})`);		if (isRetryable(err)) console.log('transient: try again later');	} else {		throw err;	}}

try:    payment = client.payments.get_by_reference("order-1042")    print("paid:", payment.uuid)except qbitflow.ValidationError as exc:  # status None: refused before sending    for field_error in exc.field_errors:        print(f"{field_error.field}: {field_error.message}")except qbitflow.NotFoundError:    print("no payment for order-1042 yet")except qbitflow.ApiError as exc:  # the base of every error the SDK raises    print(f"QBitFlow error {exc.status} {exc.code} (request {exc.request_id})")    if qbitflow.is_retryable(exc):  # network, 5xx, 429: worth trying again later        print("transient: try again later")

payment, err := client.Payments.GetByReference(ctx, "order-1042")var (	validation *qbitflow.ValidationError	notFound   *qbitflow.NotFoundError	apiErr     *qbitflow.APIError)switch {case err == nil:	fmt.Println("order-1042 paid by", payment.UUID)case errors.As(err, &validation):	// StatusCode 0: refused before sending; 400: refused by the API.	for _, f := range validation.FieldErrors {		fmt.Printf("%s: %s\n", f.Field, f.Message)	}case errors.As(err, &notFound):	fmt.Println("no payment for order-1042")case errors.As(err, &apiErr):	// Every SDK error embeds an *APIError: branch on Code, quote RequestID to support.	fmt.Printf("QBitFlow error %d %s (request %s), retryable: %v\n",		apiErr.StatusCode, apiErr.Code, apiErr.RequestID, qbitflow.IsRetryable(err))default:	log.Fatal(err)}

try {	$payment = $client->payments->getByReference('order-1042');	echo "order-1042 was paid by {$payment->uuid}\n";} catch (\QBitFlow\Exceptions\ValidationException $e) {	foreach ($e->fieldErrors as $fieldError) { // refused before sending (status 0), or a 400		echo "{$fieldError->field}: {$fieldError->message}\n";	}} catch (\QBitFlow\Exceptions\NotFoundException) {	echo "No payment for order-1042 yet\n";} catch (\QBitFlow\Exceptions\ApiException $e) {	// Branch on apiCode, never on the message; quote the request id to support.	printf("QBitFlow error %d %s (request %s), retryable: %s\n",		$e->status, $e->apiCode, $e->requestId, $e->isRetryable() ? 'yes' : 'no');}