Deductions
Documents
Management
Sandbox
- POSTCreate a new Sandbox Connection
- POSTCreate a new sandbox account
- PUTUpdate a sandbox account
- GETGet configurations for sandbox jobs
- PUTUpdate configurations for sandbox jobs
- POSTAdd a new sandbox payment
- PUTUpdate sandbox individual
- PUTUpdate sandbox employment
- POSTAdd new individuals to a sandbox company
- PUTUpdate a sandbox company's data
- POSTEnqueue a new sandbox job
Development Guides
Add a new sandbox payment
import Finch from '@tryfinch/finch-api';
const client = new Finch({
accessToken: 'My Access Token',
});
async function main() {
const payment = await client.sandbox.payment.create();
console.log(payment.payment_id);
}
main();
{
"payment_id": "<string>",
"pay_date": "<string>"
}
All fields are optional. If you don’t provide a start and end date, the default start_date
is one business day after the end_date
of the most recently created payment, and the default end_date
is start_date
+ 14 business days. The default pay_date
is the end_date
and the default debit_date
is one business day after the pay_date
.
You may override any fields in the pay statements you would like. By default, no taxes, earnings or deductions are created (unless an individual is enrolled in deductions via the /benefits
endpoints).
Authorizations
Please use your Access Token
Body
Fields to configure the payment. Takes all fields from the /payment
endpoint. All fields are optional.
A stable Finch id
(UUID v4) for an individual in the company
The type of the payment associated with the pay statement.
regular_payroll
, off_cycle_payroll
, one_time_payment
The payment method.
check
, direct_deposit
The number of hours worked for this pay period
The array of earnings objects associated with this pay statement
The type of earning.
salary
, wage
, reimbursement
, overtime
, severance
, double_overtime
, pto
, sick
, bonus
, commission
, tips
, 1099
, other
The exact name of the deduction from the pay statement.
The earnings amount in cents.
The earnings currency code.
The number of hours associated with this earning. (For salaried employees, this could be hours per pay period, 0
or null
, depending on the provider).
The array of taxes objects associated with this pay statement.
The type of taxes.
state
, federal
, local
, fica
The exact name of tax from the pay statement.
true
if the amount is paid by the employers.
The tax amount in cents.
The currency code.
The array of deductions objects associated with this pay statement.
The deduction name from the pay statement.
The deduction amount in cents.
The deduction currency.
Boolean indicating if the deduction is pre-tax.
Type of benefit.
401k
, 401k_roth
, 401k_loan
, 403b
, 403b_roth
, 457
, 457_roth
, s125_medical
, s125_dental
, s125_vision
, hsa_pre
, hsa_post
, fsa_medical
, fsa_dependent_care
, simple_ira
, simple
, commuter
, custom_post_tax
, custom_pre_tax
The contribution name from the pay statement.
The contribution amount in cents.
The contribution currency.
Type of benefit.
401k
, 401k_roth
, 401k_loan
, 403b
, 403b_roth
, 457
, 457_roth
, s125_medical
, s125_dental
, s125_vision
, hsa_pre
, hsa_post
, fsa_medical
, fsa_dependent_care
, simple_ira
, simple
, commuter
, custom_post_tax
, custom_pre_tax
Was this page helpful?
import Finch from '@tryfinch/finch-api';
const client = new Finch({
accessToken: 'My Access Token',
});
async function main() {
const payment = await client.sandbox.payment.create();
console.log(payment.payment_id);
}
main();
{
"payment_id": "<string>",
"pay_date": "<string>"
}