Payment Intents

Confirming Payment Intents

Copy page

Confirming Payment Intents

Once a Payment Intent is created, it must be confirmed with a payment method. This step authorizes the payment and moves the intent toward completion.

API Endpoint

POST /api/payment-intent/{intentId}/confirm

Request Parameters

Parameter	Location	Type	Description
intentId	Path	string	The ID of the Payment Intent to confirm

Request Body

Field	Type	Required	Description
paymentMethodId	string	Yes	The ID of the payment method to use
contact	object	No	Updated contact information
creditCardDetails	object	No	Credit card details if applicable

Example Request (REST API)

Code
 
{
    "paymentMethodId": "pm_abc123",
    "contact": {
        "name": "Jane Smith",
        "email": "jane@example.com"
    }
}

For credit card payments:

Code
 
{
    "paymentMethodId": "pm_card_123",
    "creditCardDetails": {
        "cardNumber": "4111111111111111",
        "expMonth": "12",
        "expYear": "2027",
        "cvc": "123"
    }
}

Example Response

Code
 
{
    "success": true,
    "data": {
        "id": "pi_abc123",
        "status": "requires_action",
        "paymentMethodUsed": "pm_abc123",
        "amount": 10000,
        "nextAction": {
            "type": "redirect",
            "redirectUrl": "https://api.paymongo.com/v1/payment_intents/pi_abc123/authenticate?token=xxx"
        }
    }
}

Using the SDK

Code
 
import { SaligPay } from "saligpay-node";

const saligpay = new SaligPay({
    clientId: process.env.SALIGPAY_CLIENT_ID!,
    clientSecret: process.env.SALIGPAY_CLIENT_SECRET!,
    env: "sandbox",
});

try {
    const confirmation = await saligpay.paymentIntents.confirm("pi_abc123", {
        paymentMethod: "pm_gcash_xyz",
        contact: {
            name: "Jane Smith",
            email: "jane@example.com",
        },
    });

    console.log("Payment Intent Confirmed:", confirmation);

    if (confirmation.requiresAction && confirmation.nextAction) {
        if (confirmation.nextAction.type === "redirect") {
            console.log("Redirect URL:", confirmation.nextAction.redirectUrl);
        }
    }
} catch (error) {
    console.error("Error confirming payment intent:", error);
}

For credit card payments:

Code
 
const confirmation = await saligpay.paymentIntents.confirm("pi_abc123", {
    paymentMethod: "pm_card_visa",
    creditCardDetails: {
        cardNumber: "4111111111111111",
        expMonth: "12",
        expYear: "2027",
        cvc: "123",
    },
});

Payment Confirmation Flow

1. Initial Confirmation: Submit the payment method ID to the API
2. Status Check: The API returns the current status
3. Additional Action: If authentication is required, redirect or handle accordingly
4. Final Status: Wait for the final payment status

Handling Different Payment Methods

GCash and Maya Payments

Most e-wallet payments will require a redirect for authentication:

Code
 
const confirmation = await saligpay.paymentIntents.confirm(intentId, {
    paymentMethod: "pm_gcash_xyz",
});

if (confirmation.requiresAction && confirmation.nextAction) {
    window.location.href = confirmation.nextAction.redirectUrl;
}

Card Payments

Card payments may require 3D Secure authentication:

Code
 
const confirmation = await saligpay.paymentIntents.confirm(intentId, {
    paymentMethod: "pm_card_visa",
    creditCardDetails: {
        cardNumber: "4111111111111111",
        expMonth: "12",
        expYear: "2027",
        cvc: "123",
    },
});

if (confirmation.requiresAction && confirmation.nextAction) {
    handleThreeDSecure(confirmation.nextAction.redirectUrl);
}

Status Transitions After Confirmation

After confirming a Payment Intent, it may transition through:

1. requires_action - Additional authentication required
2. processing - Payment is being processed
3. succeeded - Payment completed successfully
4. failed - Payment failed
5. canceled - Payment was canceled

Error Handling

Common errors when confirming Payment Intents:

Error Code	Description	Solution
PAYMENT_METHOD_INVALID	Payment method is not valid	Verify payment method ID and status
INSUFFICIENT_FUNDS	Insufficient funds in payment method	Ask customer to use another payment method
3D_SECURE_REQUIRED	3D Secure authentication required	Complete authentication flow
INTENT_ALREADY_CONFIRMED	Intent has already been confirmed	Check intent status before confirming