API Reference

Payment object

A payment represents a charge to your customer's credit or debit card.

When you want to pay a Payment before, you must create a Source and attach it to the Payment through the authorize resource. If the Source gateway belongs to a payment gateway with single_use usage, it should be paid through the pay resource, while if it belongs to a payment gateway with reusable usage, it will immediately try to charge the credit or debit card of the customer.

Attributes


id

string
Unique identifier of the object.


date

string
A positive number representing the amount to charge.


amount

number
A date equal to or greater than today in yyyy-mm-dd format.


currency

string
Three-letter ISO code for the currency of the payment.


description

string
A description for payment with a max length of 256 characters.


source

object
ID of the source with which the Payment was processed. The Source is attached through the or the , depending on the type of charge required.


payment_date

timestamp
Time at which the Payment was payed in format yyyy-mm-dd hh:mm:ss


customer

object
ID of the Customer this payment belongs to, of one exists.


invoice

object
ID of the Invoice this payment belongs to, of one exists. It will have this attribute when the payment is created from an invoice from the .


status

string
The status of the Source, one of requires_payment_method, processing, succeeded or canceled. The default status when the Payment is created is requires_payment_method.


metadata

object
Set of key-value pairs that you can attach to an object. This can be useful for storing additional information about the object in a structured format. All keys can be unset by posting an empty value to metadata.


created

timestamp
Time at which the object was created in format yyyy-mm-dd hh:mm:ss


updated

timestamp
Time at which the object was updated in format yyyy-mm-dd hh:mm:ss


Object sample

{
    "id": "pay_ck6HZUxJR598PZf0uZ",
    "date": "2020-04-28",
    "amount": 12.50,
    "description": "Payment example via API",
    "status": "processing",
    "payment_date": null,
    "metadata": {},
    "created": "2020-04-10T13:48:55.259886-04:00",
    "updated": "2020-04-10T13:48:55.259903-04:00",
    "invoice": null,
    "customer": null,
    "currency": "CLP",
    "source": {
        "id": "sou_NBm22nauWP1YqUuY7G",
        "amount": 12.50,
        "description": null,
        "return_url": null,
        "status": "chargeable",
        "metadata": {},
        "created": "2020-04-10T18:21:02.871850-04:00",
        "updated": "2020-04-10T18:21:07.124700-04:00",
        "customer": null,
        "gateway": "paypal",
        "usage": "single",
        "flow": "redirect",
        "data": {
            "redirect_url": "https://www.paypal.com/cgi-bin/webscr?cmd=_express-checkout&token=EC-ASLS84461XM815581J"
        }
    }
}