A Source is a resource to generate your customer's payment instrument. This is normally used to generate check out URLs for e-wallet payments. To learn more about e-wallet integrations, you can visit GCash or GrabPay integration.

A Source Resource

{
    "data": {
        "id": "src_1bLmj5BnqV2fCnM1SGGTdcrf",
        "type": "source",
        "attributes": {
            "amount": 10000,
            "billing": {
                "address": {
                    "city": "Taguig",
                    "country": "PH",
                    "line1": "9th Avenue and 26th Street, Unit 3308",
                    "line2": "High Street South Corporate Plaza Tower 2",
                    "postal_code": "1634",
                    "state": "Metro Manila"
                },
                "email": "[email protected]",
                "name": "Juan Dela Cruz",
                "phone": "09168268582"
            },
            "currency": "PHP",
            "livemode": false,
            "redirect": {
                "checkout_url": "https://test-sources.paymongo.com/sources?id=src_1bLmj5BnqV2fCnM1SGGTdcrf",
                "failed": "https://mysite.com/gcash/failed",
                "success": "https://mysite.com/gcash/success"
            },
            "status": "pending",
            "type": "gcash",
            "created_at": 1586192301,
            "updated_at": 1586192301
        }
    }
}

id string
Unique ID of the resource.


type string
Represents the resource type. Value is always source.


amount integer
amount to be authorized by the source. A positive integer with minimum amount of 10000. 10000 is the smallest unit in cents. If you want to receive an amount of 100.00, the value that you should pass is 10000. If you want to receive an amount of 1500.50, the value that you should pass is 150050. Take note that whenever you create a payment from a chargeable source, the source amount should match the Payment that you will create.


billing dictionary

Attribute

Description

address.city string

City of the billing address information

address.country string

Country of the billing address information. Possible values are ISO 3166-1 alpha-2 codes or two-letter country codes..

address.line1 string

Line1 of the billing address information

address.line2 string

Line2 of the billing address information

address.postal_code string

Postal Code of the billing address information

address.state string

State of the billing address information

email string

E-mail address of the billing information.

name string

Name of the billing information.

phone string

Phone of the billing information.


currency string
Three-letter ISO currency code, in uppercase. PHP is the only supported currency as of the moment.


livemode boolean
The value is true if the resource exists in live mode or the value is false if the resource exists in test mode.


redirect dictionary

Attribute

Description

success string

URL to redirect the customer once authorization is successful.

failed string

URL to redirect the customer if the authorization encountered an error.


status string
Status of the Source. Possible values are pending, chargeable, cancelled, expired, and paid.


attributes.type string
The type of source. Possible values are gcash and grab_pay.


created_at timestamp
The timestamp when the payment method has been created.


updated_at timestamp
The timestamp when the source has been updated.