If you’re using FreshBooks Classic, click here.

Online Payments API

General Info

In FreshBooks, invoices can be paid online via a variety of payment gateways setup on the sender's account. In order for this to be available on an invoice, the online payments must be set up through a separate call after the invoice has been created.

While default payment options exist, they are not automatically applied to new invoices and must be retrieved and added manually.

Requires Authorization

Includes

There are no includes for online payments.

Filters

There are no filters for online payments.

Field Descriptions

underlined fields are required on creation

Field	Type	Description
gateway_name	string	Payment gateway name. The available gateway_names are as follows: - WePay: "fbpay" - Stripe: "stripe" - PayPal: "paypal"
has_credit_card	bool	If the invoice can accept credit cards
has_ach_transfer	bool	If the invoice can accept ACH bank transfers
has_bacs_debit	bool
has_sepa_debit	bool
has_paypal_smart_checkout	bool
allow_partial_payments	bool	If the client can use the gateway to pay part of the invoice or only the full amount.
entity_type	string	Eg. "invoices"
entity_id	int	invoice_id of the connected invoice
gateway_info	object	Additional gateway details

curl

Get the Default Invoice Payment Options

curl -L -X GET 'https://api.freshbooks.com/payments/account/<accountId>/payment_options?entity_type=invoice' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer <insert-bearer-token>'

#Response
{
    "payment_options": {
        "gateway_name": null,
        "has_credit_card": false,
        "has_ach_transfer": false,
        "has_bacs_debit": false,
        "has_sepa_debit": false,
        "has_acss_debit": false,
        "stripe_acss_payment_options": null,
        "has_paypal_smart_checkout": false,
        "allow_partial_payments": false,
        "entity_type": "invoice",
        "entity_id": null,
        "gateway_info": null
    }
}

Add a Payment Option to an invoice

Request: POST https://api.freshbooks.com/payments/account/<accountid>/invoice/<invoiceid>/payment_options

{
   "gateway_name":"stripe",
   "entity_id": 2168250,
   "entity_type":"invoice",
   "has_credit_card":true
}

Response:

{
   "payment_options": {
      "gateway_name": "stripe", 
      "has_credit_card": true, 
      "has_ach_transfer": false, 
      "has_bacs_debit": false, 
      "has_sepa_debit": false, 
      "has_paypal_smart_checkout": false, 
      "allow_partial_payments": false, 
      "entity_type": "invoice", 
      "entity_id": "5370347", 
      "gateway_info": {
      ...
      }
   }
}

See Payment Options on an invoice

Request: GET https://api.freshbooks.com/payments/account/<accountid>/invoice/<invoiceid>/payment_options