Create a payment intent

You only need an amount. Add more details to fill in checkout for the customer, limit how they pay, or charge a method they saved before. Every option is listed in Payment intents.

Just the amount

The simplest case: all you need is the amount to charge. This is the most basic setup.

Situation: You want a customer to pay GMD 450, and you’re not adding a customer record or any other optional details.
Request:

const paymentIntent = await modempay.paymentIntents.create({ amount: 450 });

payment_intent = modem_pay.payment_intents.create(params={"amount": 450})

$payment_intent = $modemPay->paymentIntents()->create(['amount' => 450]);

cURL -X POST "https://api.modempay.com/v1/payments" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <your_api_key>" \
  -d '{
    "data": {
      "amount": 450,
      "from_sdk": false
    }
  }'

Result: A Payment Intent is created, along with a link to the payment page where the customer pays.

{
  "status": true,
  "message": "Payment intent created successfully. Please proceed to complete the payment.",
  "data": {
    "intent_secret": "8816a8e679d9df252fa80d09ebe21efaa3a8980cb053cb64afeed44c5df696f4",
    "payment_link": "https://test.checkout.modempay.com/6b63ccef-0232-4be1-b53d-be6823767874",
    "amount": 450,
    "currency": "GMD",
    "expires_at": "2025-02-13T12:31:15.601Z",
    "status": "requires_payment_method"
  }
}

Amount and customer

Here you add the customer who’s paying, on top of the amount. This ties the payment to a specific customer so it’s easier to keep track of.

Situation: You want to charge GMD 450 and link it to a particular customer.
Request:

const paymentIntent = await modempay.paymentIntents.create({
    amount: 450,
    customer: "d9bf8831-4db5-4a1c-8aa0-3de72492f330",
});

payment_intent = modem_pay.payment_intents.create(
    params={"amount": 450, "customer": "d9bf8831-4db5-4a1c-8aa0-3de72492f330"}
)

$payment_intent = $modemPay->paymentIntents()->create([
    'amount' => 450,
    'customer' => 'd9bf8831-4db5-4a1c-8aa0-3de72492f330',
]);

cURL -X POST "https://api.modempay.com/v1/payments" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <your_api_key>" \
  -d '{
    "data": {
      "amount": 450,
      "customer": "d9bf8831-4db5-4a1c-8aa0-3de72492f330",
      "from_sdk": false
    }
  }'

Amount, customer, and payment methods

A more specific setup: you set the amount, link a customer, and decide ahead of time which payment methods the customer can use. Handy when you want to limit things to certain methods.

Situation: You want to charge GMD 450, link it to a customer, and only allow a particular payment method.
Request:

const paymentIntent = await modempay.paymentIntents.create({
    amount: 450,
    customer: "d9bf8831-4db5-4a1c-8aa0-3de72492f330",
    payment_methods: ["card"],
});

payment_intent = modem_pay.payment_intents.create(
    params={
        "amount": 450,
        "customer": "d9bf8831-4db5-4a1c-8aa0-3de72492f330",
        "payment_methods": ["card"],
    }
)

$payment_intent = $modemPay->paymentIntents()->create([
    'amount' => 450,
    'customer' => 'd9bf8831-4db5-4a1c-8aa0-3de72492f330',
    'payment_methods' => ['card'],
]);

cURL -X POST "https://api.modempay.com/v1/payments" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <your_api_key>" \
  -d '{
    "data": {
      "amount": 450,
      "customer": "d9bf8831-4db5-4a1c-8aa0-3de72492f330",
      "payment_methods": ["card"],
      "from_sdk": false
    }
  }'

Amount, customer, and a specific saved payment method

Here you point to one of the customer’s saved payment methods by its ID. Useful when you want to charge a saved card or bank account directly.

Situation: You want to charge GMD 450, link it to a customer, and use a specific saved payment method from their account. This lets you charge a saved method straight away, which makes things quicker for returning customers.
Request:

const paymentIntent = await modempay.paymentIntents.create({
    amount: 450,
    payment_method: "ad47ccb9-687c-475b-90dc-1dd3b4cba68e",
    customer: "d9bf8831-4db5-4a1c-8aa0-3de72492f330",
});

payment_intent = modem_pay.payment_intents.create(
    params={
        "amount": 450,
        "payment_method": "ad47ccb9-687c-475b-90dc-1dd3b4cba68e",
        "customer": "d9bf8831-4db5-4a1c-8aa0-3de72492f330",
    }
)

$payment_intent = $modemPay->paymentIntents()->create([
    'amount' => 450,
    'payment_method' => 'ad47ccb9-687c-475b-90dc-1dd3b4cba68e',
    'customer' => 'd9bf8831-4db5-4a1c-8aa0-3de72492f330',
]);

cURL -X POST "https://api.modempay.com/v1/payments" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <your_api_key>" \
  -d '{
    "data": {
      "amount": 450,
      "customer": "d9bf8831-4db5-4a1c-8aa0-3de72492f330",
      "payment_method": "ad47ccb9-687c-475b-90dc-1dd3b4cba68e",
      "from_sdk": false
    }
  }'

Send the customer to data.payment_link, then confirm the payment with a webhook or by checking it.

Get started

Developer tools

Accept payments

Payment intents

Customers and discounts

Send money

Split payments

Stablecoins

In person

Your money

Webhooks

Create a payment intent

Just the amount

Amount and customer

Amount, customer, and payment methods

Amount, customer, and a specific saved payment method

Next

​Just the amount

​Amount and customer

​Amount, customer, and payment methods

​Amount, customer, and a specific saved payment method

​Next

Just the amount

Amount and customer

Amount, customer, and payment methods

Amount, customer, and a specific saved payment method

Next