RoadSyncPay Public API (1.0)

Download OpenAPI specification:Download

Jack Roberts: support@roadsync.com URL: https://roadsnc.com License: Proprietary Terms of Service

RoadSync Pay API

payees

The payees end point

Get a List of All Payees

Return a list of all Payees associated with a Broker.

Securityx-api-key
Request
query Parameters
broker_id
integer (broker_id)

The id of the broker

Example: broker_id=66305
Responses
200

Example response

get/payees
Request samples 
Response samples 
application/json
[
  • {
    }
]
Create a Payee
Create a Payee.


Securityx-api-key 
Request 
Request Body schema: application/json
broker_id
integer (broker_id) 
The identifier of a Broker to which the Payee will be assigned or has already been assigned.


 
payee_name
string (payee_name) 
The name of the Carrier or Factoring Company.


 
mc_number
string (mc_number) 
Motor Carrier Number is a a nine-digit identifier assigned by the FMCSA to moving companies operating in interstate commerce. If inserted, it will be validated.


 
dot_number
string (dot_number) 
U.S. Department of Transportation Number is an up to ten-digit assigned by the FMCSA to moving companies operating in interstate commerce. If inserted, it will be validated.


 
email_address
string (email_address) 
A valid email belonging to the person or company.


 
phone_number
string (phone_number) 
A valid phone number belonging to a person or company.


 
first_name
string (first_name) 
The first name of a contact or user.


 
last_name
string (last_name) 
The last name of a user or contact.


 
addressLineOne
string (address_line_one) 
The valid address of a person or business in the United States.


 
address_line_two
string (address_line_two) 
If necessary, add a second line of the address in the United States.


 
city
string (city) 
A valid city in the United States.


 
state
string (state) 
A valid 2 character state code in the United States.


 
postal_code
string (postal_code) 
A valid postal code in the United States.


 
is_factoring_company
boolean (is_factoring_company) 
Send "true" if this Payee is a Factoring Company, "false" otherwise.


 
ach_funding_source_id
integer (id) 
The id number of the object being returned.


 
paper_check_funding_source_id
integer (id) 
The id number of the object being returned.


 
available_payment_types
Array of any (available_payment_types) 
A list of the availablepayment methods a Payee is able to receive. Possible values are PAPERCHECK, ACH, RTP


Items Enum: "ACH" "PAPERCHECK" "RTP"  
is_verified
boolean (is_verified) 
A verified Payee is visible to all brokers in the RoadSync Pay environment. Some partners are allowed to verify a Payee by setting the is_verified flag to true during creation or update.


 
payee_candidate_id
integer (payee_candidate_id) 
This field is displayed if the Payee is available in RoadSync Pay’s Directory.


 
carrier_payee_ids
Array of integers (carrier_payee_ids) 
If “is_factoring_company“ is true, add the “payee_id” for each associated carrier.


 
Responses 
201
Example response


400
Bad Request


409
Conflict


post/payees
Request samples 
application/json
{
  • "broker_id": 66305,
  • "payee_name": "Camila Trucking LLC",
  • "mc_number": "MC612791",
  • "dot_number": "2428196",
  • "email_address": "crogers@camilatrucking.com",
  • "phone_number": "3243444347",
  • "first_name": "Camila",
  • "last_name": "Rogers",
  • "addressLineOne": "715 Peachtree St",
  • "address_line_two": "APT 23",
  • "city": "Atlanta",
  • "state": "GA",
  • "postal_code": "30306",
  • "is_factoring_company": true,
  • "ach_funding_source_id": 87346,
  • "paper_check_funding_source_id": 87346,
  • "available_payment_types": [
    ],
  • "is_verified": false,
  • "payee_candidate_id": 896876,
  • "carrier_payee_ids": [
    ]
}
Response samples 
application/json
{
  • "broker_id": 66305,
  • "payee_name": "Camila Trucking LLC",
  • "mc_number": "MC612791",
  • "dot_number": "2428196",
  • "email_address": "crogers@camilatrucking.com",
  • "phone_number": "3243444347",
  • "first_name": "Camila",
  • "last_name": "Rogers",
  • "addressLineOne": "715 Peachtree St",
  • "address_line_two": "APT 23",
  • "city": "Atlanta",
  • "state": "GA",
  • "postal_code": "30306",
  • "is_factoring_company": true,
  • "ach_funding_source_id": 87346,
  • "paper_check_funding_source_id": 87346,
  • "available_payment_types": [
    ],
  • "is_verified": false,
  • "payee_candidate_id": 896876,
  • "carrier_payee_ids": [
    ]
}
Get a Single Payee
Retrieve the information of one specific Payee.


Securityx-api-key 
Request 
path Parameters
id
required
integer (id) 
The id number of the object being returned.


 
 Example:  87346
Responses 
200
Example response


get/payees/{id}
Request samples 
Response samples 
application/json
{
  • "broker_id": 66305,
  • "payee_name": "Camila Trucking LLC",
  • "mc_number": "MC612791",
  • "dot_number": "2428196",
  • "email_address": "crogers@camilatrucking.com",
  • "phone_number": "3243444347",
  • "first_name": "Camila",
  • "last_name": "Rogers",
  • "addressLineOne": "715 Peachtree St",
  • "address_line_two": "APT 23",
  • "city": "Atlanta",
  • "state": "GA",
  • "postal_code": "30306",
  • "is_factoring_company": true,
  • "ach_funding_source_id": 87346,
  • "paper_check_funding_source_id": 87346,
  • "available_payment_types": [
    ],
  • "is_verified": false,
  • "payee_candidate_id": 896876,
  • "carrier_payee_ids": [
    ]
}
Update a Single Payee
Edit the information of the specified Payee. Only Payees that are not verified can be updated.


Securityx-api-key 
Request 
path Parameters
id
required
integer (id) 
The id number of the object being returned.


 
 Example:  87346
Request Body schema: application/json
externalId
string (external_id) 
A unique identifier you have for the Carrier or Factoring Company.


 
payee_name
string (payee_name) 
The name of the Carrier or Factoring Company.


 
mc_number
string (mc_number) 
Motor Carrier Number is a a nine-digit identifier assigned by the FMCSA to moving companies operating in interstate commerce. If inserted, it will be validated.


 
dot_number
string (dot_number) 
U.S. Department of Transportation Number is an up to ten-digit assigned by the FMCSA to moving companies operating in interstate commerce. If inserted, it will be validated.


 
email_address
string (email_address) 
A valid email belonging to the person or company.


 
phone_number
string (phone_number) 
A valid phone number belonging to a person or company.


 
addressLineOne
string (address_line_one) 
The valid address of a person or business in the United States.


 
address_line_two
string (address_line_two) 
If necessary, add a second line of the address in the United States.


 
city
string (city) 
A valid city in the United States.


 
state
string (state) 
A valid 2 character state code in the United States.


 
postal_code
string (postal_code) 
A valid postal code in the United States.


 
first_name
string (first_name) 
The first name of a contact or user.


 
last_name
string (last_name) 
The last name of a user or contact.


 
factoring_company_id
integer (id) 
The id number of the object being returned.


 
carrier_payee_ids
Array of integers (carrier_payee_ids) 
If “is_factoring_company“ is true, add the “payee_id” for each associated carrier.


 
Responses 
201
Example response


400
Bad Request


401
Unauthorized


403
Example response


404
Not Found


patch/payees/{id}
Request samples 
application/json
{
  • "externalId": "14973-83",
  • "payee_name": "Camila Trucking LLC",
  • "mc_number": "MC612791",
  • "dot_number": "2428196",
  • "email_address": "crogers@camilatrucking.com",
  • "phone_number": "3243444347",
  • "addressLineOne": "715 Peachtree St",
  • "address_line_two": "APT 23",
  • "city": "Atlanta",
  • "state": "GA",
  • "postal_code": "30306",
  • "first_name": "Camila",
  • "last_name": "Rogers",
  • "factoring_company_id": 87346,
  • "carrier_payee_ids": [
    ]
}
Response samples 
application/json
{
  • "broker_id": 66305,
  • "payee_name": "Camila Trucking LLC",
  • "mc_number": "MC612791",
  • "dot_number": "2428196",
  • "email_address": "crogers@camilatrucking.com",
  • "phone_number": "3243444347",
  • "first_name": "Camila",
  • "last_name": "Rogers",
  • "addressLineOne": "715 Peachtree St",
  • "address_line_two": "APT 23",
  • "city": "Atlanta",
  • "state": "GA",
  • "postal_code": "30306",
  • "is_factoring_company": true,
  • "ach_funding_source_id": 87346,
  • "paper_check_funding_source_id": 87346,
  • "available_payment_types": [
    ],
  • "is_verified": false,
  • "payee_candidate_id": 896876,
  • "carrier_payee_ids": [
    ]
}
Delete a Single Payee
Delete Payee from the Broker's list of Payees.


Securityx-api-key 
Request 
path Parameters
id
required
integer (id) 
The id number of the object being returned.


 
 Example:  87346
Responses 
200
OK


403
Example response


404
Not Found


delete/payees/{id}
Request samples 
Response samples 
application/json
{
  • "Code": "ForbiddenError",
  • "Message": "Action forbidden"
}
Copyright © RoadSync 2023. All right reserved.