PayBills – Developer Support

About PayBills

Use this API to issue Bill.com payments (one or more bills and one or more bill credits) to a designated Vendor. These are paid from a specified bank account.

This is a Multi Factor Authentication (MFA) trusted endpoint. For more information, see the Multi Factor Authentication Workflow in order to establish an MFA trusted session prior to using this endpoint.

Note: Developers who joined the Developer Program and used this endpoint prior to March 31st, 2017 will not require an MFA Trusted Session to use this endpoint and can continue using this endpoint as they normally would.

The user that calls this API needs to be assigned the Administrator, Payer, or customized User Role Profile with the pay bills permission enabled. If not, an error is returned when the user tries to pay a bill.

This is how the payment is processed in the Bill.com system:

If a process date is not specified, payment is sent on the next bank work day.

The earliest available process date is the next business day, not including holidays.
Payments will not process on weekends or bank holidays
The process date for a payment cannot be changed/edited once a payment is scheduled

If vendor is setup for ePayment, funds are transferred by ACH. Otherwise, a check is sent (via UPS) to vendor's address.
Any memo information entered in the description field is included on the check or a bank descriptor for ePayment.
You can pay a maximum of 200 Bills in one PayBills request.
You can specify which bank account to use with the parameter bankAccountId

Example

Note: To apply a Vendor Credit, the nested billCredits array must include billId, vendorCreditId and amount applied to the specified bill. The nested billPays array must include billId and amount applied to the specified bill.

Request

<API_URL_EndPoint>/PayBills.json

data={
 "vendorId" : "00901AYXJFMTDDO4xat5",
 "processDate" : "2017-01-19",
 "billPays" : [ {
   "billId" : "00n01ZWAMLTSFBS5ao2z",
   "amount" : 100.00
 }, { 
   "billId" : "00n01FSFJWBRPEQ5ao4q",
   "amount" : 99.00
} ],
 "billCredits" : [ {
   "billId" : "00n01FSFJWBRPEQ5ao4q",
   "vendorCreditId" : "vcr01HPCWEVWUAR1d9bv",
   "amount" : 1.00
 } ]
}

Response

{
 "response_status" : 0,
 "response_message" : "Success",
 "response_data" : {
 "sentPays" : [ {
 "entity" : "SentPay",
 "id" : "stp01WJWSEQDTWFuxzud",
 "processDate" : "2017-01-19",
 "amount" : 166.00,
 "status" : "1",
 "description" : "Acct #12198649-Multiple inv. (details on stub)",
 "txnNumber" : "VNGJHAWGCMQCBBFCVNWF",
 "name" : "P17011801 - 5611696",
 "vendorId" : "00901AYXJFMTDDO4xat5",
 "isOnline" : true,
 "paymentType" : "0",
 "chartOfAccountId" : "0ca01JSZETHAFXE62xr3",
 "syncReference" : null,
 "toPrintCheck" : false,
 "createdTime" : "2017-01-18T18:44:12.000+0000",
 "updatedTime" : "2017-01-18T18:44:12.000+0000",
 "bankAccountId" : "bac01PKPPVUUEPZGdj0y",
 "billPays" : [ {
   "entity" : "BillPay",
     "id" : "blp01GPBBKBKIF1qvmhz",
     "billId" : "00n01ZWAMLTSFBS5ao2z",
     "name" : "P17011801 - 5611696",
     "paymentStatus" : "1",
     "amount" : 100.00,
     "description" : "Acct #12198649-Multiple inv. (details on stub)",
     "processDate" : "2017-01-19",
     "createdTime" : "2017-01-18T18:44:12.000+0000",
     "updatedTime" : "2017-01-18T18:44:12.000+0000",
     "paymentType" : "0",
     "syncReference" : null,
     "toPrintCheck" : false,
     "chartOfAccountId" : "0ca01JSZETHAFXE62xr3"
   }, {
   "entity" : "BillPay",
     "id" : "blp01JWKRENZIS1qvmi0",
     "billId" : "00n01FSFJWBRPEQ5ao4q",
     "name" : "P17011801 - 5611696",
     "paymentStatus" : "1",
     "amount" : 66.00,
     "description" : "Acct #12198649-Multiple inv. (details on stub)",
     "processDate" : "2017-01-19",
     "createdTime" : "2017-01-18T18:44:12.000+0000",
     "updatedTime" : "2017-01-18T18:44:12.000+0000",
     "paymentType" : "0",
     "syncReference" : null,
     "toPrintCheck" : false,
     "chartOfAccountId" : "0ca01JSZETHAFXE62xr3"
 } ],
 "billCredits" : [ {
   "entity" : "BillCredit",
   "id" : "bcr01IMMIHDAECJ10t7u",
   "isActive" : "1",
   "billId" : "00n01FSFJWBRPEQ5ao4q",
   "sentPayId" : "stp01WJWSEQDTWFuxzud",
   "vendorCreditId" : "vcr01HPCWEVWUAR1d9bv",
   "amount" : 0.90,
   "createdTime" : "2017-01-18T18:44:12.000+0000",
   "updatedTime" : "2017-01-18T18:44:12.000+0000"
 } ],
 "voidRequests" : [ ]
 } ]
 }
}

Resources

Parameters

Field Name	Description	Required?
vendorId	The system generated ID of the Vendor to be paid.	Yes
bankAccountId	Bank account to withdraw money.If account ID not provided, use default primary payables bank account.	No
processDate	Process date for paid bills. Funds are withdrawn on this date. If process date not passed, next available business date is used.	No
billPays	Array of one or more bills (up to 200) to be paid. Object contains fields described above in billPay object definition.	Yes
billId amount	The Id of the bill to be paid. The amount of the bill to be paid.	Yes
billCredits	Array of one or more vendor credits to be applied. Object contains fields as described above in billCredit object definition.	No
billId vendorCreditId amount	The system generated ID of the bill to be paid. The system generated ID of the vendorCredit. The amount of the vendor credit to be applied.	Yes (only if a billCredit)
description	Memo for payment description.	No