Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
20 changes: 20 additions & 0 deletions .env.example
Original file line number Diff line number Diff line change
Expand Up @@ -27,3 +27,23 @@ TERMII_SENDER_ID=
UPLOAD_DIR=.local/evidence
UPLOAD_STORAGE=database
SEED_DEVELOPMENT=false

SMSPOOL_API_KEY=
FIVESIM_API_KEY=

BOOSTERO_API_KEY=
SMMKINGS_API_KEY=

PRESTMIT_API_KEY=
PRESTMIT_API_SECRET=
PRESTMIT_WEBHOOK_SECRET=

FINCRA_SECRET_KEY=
FINCRA_BUSINESS_ID=
FINCRA_WEBHOOK_SECRET=

GIFT_BUY_MARKUP_BPS=300
GIFT_SELL_MARGIN_BPS=200
VIRTUAL_NUMBER_MARKUP_BPS=2000
SOCIAL_BOOST_MARKUP_BPS=3000
EXCHANGE_MARKUP_BPS=100
10 changes: 3 additions & 7 deletions apps/api/src/app/api/v1/gift-cards/purchases/route.ts
Original file line number Diff line number Diff line change
@@ -1,8 +1,4 @@
import { endpoint } from "@quickpay/server/shared/infrastructure/http";
import { identity } from "@quickpay/server/shared/auth";
import { giftCardBuyer } from "@quickpay/server/v1/modules/gift-cards/providers/purchase-provider";
import { json } from "@quickpay/server/shared/infrastructure/http";
export const POST = endpoint(async (req) => {
await identity(req);
return json(await giftCardBuyer.catalog());
});
import { purchases } from "@quickpay/server/v1/modules/gift-cards/routes/purchases";
export const GET = endpoint(purchases);
export const POST = endpoint(purchases);
4 changes: 4 additions & 0 deletions apps/api/src/shared/infrastructure/env.ts
Original file line number Diff line number Diff line change
Expand Up @@ -2,6 +2,10 @@ import "dotenv/config";
import { z } from "zod";
import { ConfigurationError } from "../errors";
const schema = z.object({
SMSPOOL_API_KEY: z.string().default(""),
FIVESIM_API_KEY: z.string().default(""),
BOOSTERO_API_KEY: z.string().default(""),
SMMKINGS_API_KEY: z.string().default(""),
DATABASE_URL: z.url(),
WEB_ORIGIN: z.url().default("http://localhost:3000"),
API_ORIGIN: z.url().default("http://localhost:3001"),
Expand Down
9 changes: 8 additions & 1 deletion apps/api/src/v1/modules/admin/routes/handler.ts
Original file line number Diff line number Diff line change
@@ -1,3 +1,4 @@
import { env } from "../../../../shared/infrastructure/env";
import { z } from "zod";
import { atomic, pool, enqueue } from "@quickpay/database";
import { authorized } from "../../../../shared/auth";
Expand Down Expand Up @@ -263,10 +264,16 @@ async function reviewGift(req: Request) {
const {
rows: [sale],
} = await c.query(
"SELECT s.*,q.amount,e.status evidence_status FROM gift_sales s JOIN gift_quotes q ON q.id=s.quote_id JOIN evidence e ON e.id=s.evidence_id WHERE s.id=$1 FOR UPDATE OF s",
"SELECT s.*,q.amount,p.sandbox_only,e.status evidence_status FROM gift_sales s JOIN gift_quotes q ON q.id=s.quote_id JOIN gift_products p ON p.id=q.product_id JOIN evidence e ON e.id=s.evidence_id WHERE s.id=$1 FOR UPDATE OF s",
[v.id],
);
assert(sale, "NOT_FOUND", "Sale not found.", 404);
assert(
!sale.sandbox_only || env().PAYMENT_MODE === "sandbox",
"SANDBOX_ONLY",
"Sandbox cards can only be reviewed in sandbox mode.",
409,
);
assert(
sale.user_id !== s.user.id,
"SELF_REVIEW",
Expand Down
138 changes: 138 additions & 0 deletions apps/api/src/v1/modules/digital-services/providers/clients.ts
Original file line number Diff line number Diff line change
@@ -0,0 +1,138 @@
import { env } from "../../../../shared/infrastructure/env";
import { DomainError } from "../../../../shared/errors";

type Payload = Record<string, string>;
async function request(
url: string,
key: string,
options: {
method: "GET" | "POST";
data?: Payload;
authorization: "bearer" | "form";
},
) {
if (!key)
throw new DomainError(
"PROVIDER_UNCONFIGURED",
"This service is currently unavailable.",
503,
);
let response: Response;
try {
response = await fetch(url, {
method: options.method,
headers: {
Accept: "application/json",
...(options.authorization === "bearer"
? { Authorization: `Bearer ${key}` }
: {}),
...(options.data
? { "Content-Type": "application/x-www-form-urlencoded" }
: {}),
},
...(options.data ? { body: new URLSearchParams(options.data) } : {}),
signal: AbortSignal.timeout(20000),
redirect: "error",
});
} catch {
throw new DomainError(
"PROVIDER_UNAVAILABLE",
"The provider could not complete this request. Please check the order status before retrying.",
503,
);
}
if (!response.ok)
throw new DomainError(
"PROVIDER_UNAVAILABLE",
"The provider could not complete this request. Please check the order status before retrying.",
503,
);
let result: unknown;
try {
result = await response.json();
} catch {
throw new DomainError(
"PROVIDER_UNAVAILABLE",
"The provider returned an unreadable response. Please check the order status before retrying.",
503,
);
}
if (
typeof result !== "object" ||
result === null ||
("error" in result && !!result.error) ||
("success" in result &&
[false, 0, "0", "false"].includes(result.success as never))
)
throw new DomainError(
"PROVIDER_REJECTED",
"The provider could not complete this request.",
409,
);
return result;
}
export const smsPool = {
call(path: string, data: Payload = {}) {
const key = env().SMSPOOL_API_KEY;
return request(`https://api.smspool.net/${path}`, key, {
method: "POST",
authorization: "form",
data: { ...data, key },
});
},
countries: () => smsPool.call("country/retrieve_all"),
services: () => smsPool.call("service/retrieve_all"),
price: (country: string, service: string) =>
smsPool.call("request/price", { country, service }),
purchase: (country: string, service: string, maxPrice: string) =>
smsPool.call("purchase/sms", { country, service, max_price: maxPrice }),
status: (orderid: string) => smsPool.call("sms/check", { orderid }),
cancel: (orderid: string) => smsPool.call("sms/cancel", { orderid }),
};
export const fiveSim = {
call(path: string, method: "GET" | "POST" = "GET") {
return request(`https://5sim.net/v1/${path}`, env().FIVESIM_API_KEY, {
method,
authorization: "bearer",
...(method === "POST" ? { data: {} } : {}),
});
},
prices: () => fiveSim.call("guest/prices"),
purchase: (country: string, operator: string, service: string) =>
fiveSim.call(
`user/buy/activation/${encodeURIComponent(country)}/${encodeURIComponent(operator)}/${encodeURIComponent(service)}`,
"POST",
),
status: (id: string) => fiveSim.call(`user/check/${encodeURIComponent(id)}`),
cancel: (id: string) =>
fiveSim.call(`user/cancel/${encodeURIComponent(id)}`, "POST"),
finish: (id: string) =>
fiveSim.call(`user/finish/${encodeURIComponent(id)}`, "POST"),
};
export type BoostProvider = "boostero" | "smmkings";
export function boosting(provider: BoostProvider) {
const call = (action: string, data: Payload = {}) => {
const key =
provider === "boostero" ? env().BOOSTERO_API_KEY : env().SMMKINGS_API_KEY;
return request(
provider === "boostero"
? "https://boostero.com/api/v2"
: "https://smmkings.com/api/v2",
key,
{
method: "POST",
authorization: "form",
data: { ...data, key, action },
},
);
};
return {
services: () => call("services"),
purchase: (service: string, link: string, quantity: string) =>
call("add", { service, link, quantity }),
status: (order: string) => call("status", { order }),
cancel: (orders: string) => call("cancel", { orders }),
refill: (order: string) => call("refill", { order }),
balance: () => call("balance"),
};
}
57 changes: 57 additions & 0 deletions apps/api/src/v1/modules/digital-services/providers/config.ts
Original file line number Diff line number Diff line change
@@ -0,0 +1,57 @@
import { z } from "zod";
import { ConfigurationError, DomainError } from "../../../../shared/errors";

const basisPoints = (value: number) =>
z.coerce.number().int().min(0).max(10000).default(value);
const schema = z.object({
PAYMENT_MODE: z.enum(["disabled", "sandbox", "live"]).default("disabled"),
PRESTMIT_API_KEY: z.string().trim().default(""),
PRESTMIT_API_SECRET: z.string().trim().default(""),
PRESTMIT_WEBHOOK_SECRET: z.string().trim().default(""),
FINCRA_SECRET_KEY: z.string().trim().default(""),
FINCRA_BUSINESS_ID: z.string().trim().default(""),
FINCRA_WEBHOOK_SECRET: z.string().trim().default(""),
GIFT_BUY_MARKUP_BPS: basisPoints(300),
GIFT_SELL_MARGIN_BPS: basisPoints(200),
VIRTUAL_NUMBER_MARKUP_BPS: basisPoints(2000),
SOCIAL_BOOST_MARKUP_BPS: basisPoints(3000),
EXCHANGE_MARKUP_BPS: basisPoints(100),
});
export function supplierSettings(
values: Record<string, string | undefined> = process.env,
) {
const parsed = schema.safeParse(values);
if (!parsed.success)
throw new ConfigurationError([
...new Set(parsed.error.issues.map((issue) => String(issue.path[0]))),
]);
return parsed.data;
}
export function supplierEndpoint(
provider: "prestmit" | "fincra",
mode: "disabled" | "sandbox" | "live",
) {
if (mode === "disabled")
throw new DomainError(
"SERVICE_UNAVAILABLE",
"This service is currently unavailable.",
503,
);
if (provider === "prestmit")
return mode === "live"
? "https://api.prestmit.io/partners/v1"
: "https://dev-api.prestmit.io/partners/v1";
return mode === "live"
? "https://api.fincra.com"
: "https://sandboxapi.fincra.com";
}
export function markedUpCost(costMinor: bigint, markupBps: number) {
if (
costMinor <= 0n ||
!Number.isInteger(markupBps) ||
markupBps < 0 ||
markupBps > 10000
)
throw new Error("Invalid price parameters");
return (costMinor * BigInt(10000 + markupBps) + 9999n) / 10000n;
}
125 changes: 125 additions & 0 deletions apps/api/src/v1/modules/digital-services/providers/partner-clients.ts
Original file line number Diff line number Diff line change
@@ -0,0 +1,125 @@
import { createHmac, timingSafeEqual } from "node:crypto";
import { DomainError } from "../../../../shared/errors";
import { supplierEndpoint, supplierSettings } from "./config";

type Fields = Record<string, string>;
async function responseJson(response: Response): Promise<unknown> {
if (!response.ok)
throw new DomainError(
"PROVIDER_UNAVAILABLE",
"The service could not complete this request. Check its status before retrying.",
503,
);
const data: unknown = await response.json();
if (
typeof data !== "object" ||
data === null ||
("success" in data && data.success === false)
)
throw new DomainError(
"PROVIDER_REJECTED",
"The service could not complete this request.",
409,
);
return data;
}
function requireCredentials(...values: string[]) {
if (values.some((value) => !value))
throw new DomainError(
"PROVIDER_UNCONFIGURED",
"This service is currently unavailable.",
503,
);
}
export function prestmitSignature(key: string, secret: string, fields: Fields) {
return createHmac("sha256", secret)
.update(`${key}:${JSON.stringify(fields)}`)
.digest("hex");
}
export function validPrestmitWebhook(
rawBody: string,
signature: string | null,
secret: string,
) {
if (!secret || !signature) return false;
const expected = createHmac("sha256", secret)
.update(rawBody)
.digest("base64");
const received = Buffer.from(signature);
const wanted = Buffer.from(expected);
return received.length === wanted.length && timingSafeEqual(received, wanted);
}
async function prestmitGet(path: string, fields: Fields = {}) {
const config = supplierSettings();
requireCredentials(config.PRESTMIT_API_KEY, config.PRESTMIT_API_SECRET);
const url = new URL(
`${supplierEndpoint("prestmit", config.PAYMENT_MODE)}${path}`,
);
for (const [key, value] of Object.entries(fields))
url.searchParams.set(key, value);
return responseJson(
await fetch(url, {
headers: {
"API-KEY": config.PRESTMIT_API_KEY,
"API-Hash": prestmitSignature(
config.PRESTMIT_API_KEY,
config.PRESTMIT_API_SECRET,
fields,
),
Accept: "application/json",
},
signal: AbortSignal.timeout(20000),
redirect: "error",
}),
);
}
export const prestmit = {
availability: () => prestmitGet("/general/service-availability"),
buyCatalog: (page = "1") =>
prestmitGet("/giftcard-trade/buy/fetch-buyable-giftcards", { page }),
buyConfiguration: () => prestmitGet("/giftcard-trade/buy/config"),
sellRates: () => prestmitGet("/giftcard-trade/sell/rate-calculator-data"),
wallet: () => prestmitGet("/wallet/fiat/details"),
};
export async function fincraQuote(
sourceCurrency: "NGN" | "USD" | "EUR" | "GBP",
destinationCurrency: "NGN" | "USD" | "EUR" | "GBP",
amount: string,
) {
if (
sourceCurrency === destinationCurrency ||
!/^(?:0|[1-9]\d{0,11})(?:\.\d{1,2})?$/.test(amount) ||
Number(amount) <= 0
)
throw new DomainError(
"INVALID_AMOUNT",
"Choose different currencies and a positive amount.",
400,
);
const config = supplierSettings();
requireCredentials(config.FINCRA_SECRET_KEY, config.FINCRA_BUSINESS_ID);
return responseJson(
await fetch(
`${supplierEndpoint("fincra", config.PAYMENT_MODE)}/quotes/generate`,
{
method: "POST",
headers: {
"api-key": config.FINCRA_SECRET_KEY,
"Content-Type": "application/json",
Accept: "application/json",
},
body: JSON.stringify({
sourceCurrency,
destinationCurrency,
amount,
business: config.FINCRA_BUSINESS_ID,
action: "send",
transactionType: "conversion",
paymentDestination: "fliqpay_wallet",
}),
signal: AbortSignal.timeout(20000),
redirect: "error",
},
),
);
}
Loading
Loading