Payment Intents

Creating Payment Intents

Copy page

Creating Payment Intents

Creating a Payment Intent is the first step in the payment process. This involves initializing the payment with details about the amount to collect, the customer, and other relevant information.

API Endpoint

POST /api/payment-intent

Request Body

Field	Type	Required	Description
amount	number	Yes	Amount in centavos (e.g., P100.00 = 10000)
description	string	Yes	Description of the payment
externalId	string	Yes	Unique external reference ID
contact	object	Yes	Customer contact information
contact.name	string	Yes	Customer's full name
contact.email	string	Yes	Customer's email address
contact.phone	string	No	Customer's phone number
metadata	object	No	Additional metadata
returnUrl	string	No	URL to redirect after payment
webhookUrl	string	No	URL for webhook notifications

Example Request (REST API)

Code
 
{
    "amount": 10000,
    "description": "One-time purchase",
    "externalId": "order-456",
    "contact": {
        "name": "Jane Smith",
        "email": "jane@example.com",
        "phone": "+639123456789"
    },
    "metadata": {
        "item": "premium_upgrade"
    },
    "returnUrl": "https://yourapp.com/payment/success",
    "webhookUrl": "https://yourapp.com/webhooks/saligpay"
}

Example Response

Code
 
{
    "success": true,
    "data": {
        "id": "pi_abc123",
        "transactionId": "txn_xyz789",
        "sessionToken": "550e8400-e29b-41d4-a716-446655440001",
        "amount": 10000,
        "status": "requires_payment_method",
        "clientKey": "ck_xxx",
        "paymentMethods": ["gcash", "grab_pay", "card"],
        "fee": 250,
        "createdAt": "2025-05-03T12:00:00Z",
        "updatedAt": "2025-05-03T12:00:00Z"
    }
}

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 intent = await saligpay.paymentIntents.create({
        amount: 10000,
        description: "One-time purchase",
        externalId: "order-456",
        contact: {
            name: "Jane Smith",
            email: "jane@example.com",
            phone: "+639123456789",
        },
        metadata: { item: "premium_upgrade" },
        returnUrl: "https://yourapp.com/payment/success",
        webhookUrl: "https://yourapp.com/webhooks/saligpay",
    });

    console.log("Payment Intent Created:", intent);
    console.log("Intent ID:", intent.id);
    console.log("Status:", intent.status);
    console.log("Available Payment Methods:", intent.paymentMethods);
} catch (error) {
    console.error("Error creating payment intent:", error);
}

Payment Methods Available

After creating a Payment Intent, the response will include an array of available payment methods. Common payment methods include:

• gcash - GCash wallet payments
• grab_pay - GrabPay wallet payments
• card - Credit and debit card payments
• paymaya - Maya wallet payments

Security Considerations

When creating Payment Intents:

1. Always validate the amount before sending to the API
2. Sanitize and validate all user-provided input
3. Use HTTPS for all API communications
4. Store the externalId securely to prevent duplicate charges
5. Implement proper error handling for declined payments

Error Handling

Common errors when creating Payment Intents:

Error Code	Description	Solution
VALIDATION_ERROR	Invalid input data	Check required fields and formats
AMOUNT_TOO_SMALL	Amount below minimum threshold	Increase amount to meet minimum requirements
INVALID_CONTACT_INFO	Invalid contact information	Verify contact details format
AUTHENTICATION_ERROR	Invalid API credentials	Check your API keys and authentication