Send your first SMS
in 60 seconds

1npm install @payphone/api @x402/fetch
2
3# Or with yarn
4yarn add @payphone/api @x402/fetch
5
6# Or with pnpm
7pnpm add @payphone/api @x402/fetch

1import { DialClient } from "@payphone/api";
2import { wrapFetchWithPayment } from "@x402/fetch";
3import { x402Client } from "@x402/core/client";
4import { ExactEvmScheme } from "@x402/evm/exact/client";
5import { toClientEvmSigner } from "@x402/evm";
6
7// Create your x402 payment wrapper
8const signer = toClientEvmSigner(walletClient);
9const client = new x402Client();
10client.register("eip155:*", new ExactEvmScheme(signer));
11const paidFetch = wrapFetchWithPayment(fetch, client);
12
13// Initialize Dial
14const dial = new DialClient({
15  baseUrl: "https://payphone.wtf",
16  x402Fetch: paidFetch,
17});

1// Order a US phone line ($100 activation)
2const order = await dial.numbers.buyUs({
3  country: "US",
4});
5
6console.log(order.status, order.orderId, order.promisedBy);
7// → reserved <orderId> 2026-11-03T17:00:00.000Z
8// Activated within 48 business hours, or refunded.
9// Check it with dial.numbers.buyStatus({ orderId: order.orderId }).
10
11// Or order an international line
12const intlOrder = await dial.numbers.buyIntl({
13  country: "GB",
14});

1// Send an SMS from your number
2const message = await dial.messages.send({
3  to: "+1234567890",
4  from: number,
5  body: "Hello from Dial! 👋",
6});
7
8console.log("Message ID:", message.id);
9console.log("Status:", message.status);
10// → queued
11
12// Check delivery status
13const status = await dial.messages.get(message.id);
14console.log("Delivery:", status.deliveryState);
15// → delivered