Below you will find information on all of the available endpoint actions, fields, requirements, and responses.
$contactsController = $client->getContactsController();ContactsController
Create a new Contact
function createANewContact(V1ContactsRequest $body, ?array $expand = null): ResponseContact| Parameter | Type | Tags | Description |
|---|---|---|---|
body |
V1ContactsRequest |
Body, Required | - |
expand |
?(string[]) (Expand1Enum) |
Query, Optional | Most endpoints in the API have a way to retrieve extra data related to the current record being retrieved. For example, if the API request is for the accountvaults endpoint, and the end user also needs to know which contact the token belongs to, this data can be returned in the accountvaults endpoint request. Constraints: Unique Items Required, Pattern: ^[\w]+$ |
$body = V1ContactsRequestBuilder::init(
'11e95f8ec39de8fbdb0a4f1a',
'Smith'
)
->accountNumber('54545433332')
->contactApiId('137')
->firstName('John')
->cellPhone('3339998822')
->balance(245.36)
->companyName('Fortis Payment Systems, LLC')
->headerMessage('This is a sample message for you')
->dateOfBirth('2021-12-01')
->emailTrxReceipt(true)
->homePhone('3339998822')
->officePhone('3339998822')
->officePhoneExt('5')
->headerMessageType(0)
->updateIfExists(UpdateIfExistsEnum::ENUM_1)
->contactC1('any')
->contactC2('anything')
->contactC3('something')
->parentId('11e95f8ec39de8fbdb0a4f1a')
->email('[email protected]')
->build();
$result = $contactsController->createANewContact($body);{
"type": "Contact",
"data": {
"location_id": "11e95f8ec39de8fbdb0a4f1a",
"account_number": "54545433332",
"contact_api_id": "137",
"first_name": "John",
"last_name": "Smith",
"cell_phone": "3339998822",
"balance": 245.36,
"address": {
"city": "Novi",
"state": "Michigan",
"postal_code": "48375",
"country": "US"
},
"company_name": "Fortis Payment Systems, LLC",
"header_message": "This is a sample message for you",
"date_of_birth": "2021-12-01",
"email_trx_receipt": true,
"home_phone": "3339998822",
"office_phone": "3339998822",
"office_phone_ext": "5",
"header_message_type": 0,
"update_if_exists": 1,
"contact_c1": "any",
"contact_c2": "anything",
"contact_c3": "something",
"parent_id": "11e95f8ec39de8fbdb0a4f1a",
"email": "[email protected]",
"id": "11e95f8ec39de8fbdb0a4f1a",
"created_ts": 1422040992,
"modified_ts": 1422040992,
"active": true,
"received_emails": [
{
"subject": "Payment Receipt - 12skiestech",
"body": "This email is being sent from a server.",
"source_address": "\"12skiestech A7t3qi\" <[email protected]>",
"return_path": "\"12skiestech A7t3qi\" <[email protected]>",
"provider_id": "0100017e67bcc530-e1dd23b4-8a39-4a5b-8d5d-68d51c4c942f-000000",
"domain_id": "11e95f8ec39de8fbdb0a4f1a",
"reason_sent": "Contact Email",
"reason_model": "Transaction",
"reason_model_id": "11e95f8ec39de8fbdb0a4f1a",
"reply_to": "\"Zeamster\" <[email protected]>",
"id": "11e95f8ec39de8fbdb0a4f1a",
"created_ts": 1422040992
}
],
"is_deletable": true,
"location": {
"id": "11e95f8ec39de8fbdb0a4f1a",
"created_ts": 1422040992,
"modified_ts": 1422040992,
"account_number": "5454545454545454",
"address": {
"city": "Novi",
"state": "MI",
"postal_code": "48375",
"country": "US"
},
"branding_domain_id": "11e95f8ec39de8fbdb0a4f1a",
"contact_email_trx_receipt_default": true,
"default_ach": "11e608a7d515f1e093242bb2",
"default_cc": "11e608a442a5f1e092242dda",
"email_reply_to": "[email protected]",
"fax": "3339998822",
"location_api_id": "location-111111",
"location_api_key": "AE34BBCAADF4AE34BBCAADF4",
"location_c1": "custom 1",
"location_c2": "custom 2",
"location_c3": "custom data 3",
"name": "Sample Company Headquarters",
"office_phone": "2481234567",
"office_ext_phone": "1021021209",
"tz": "America/New_York",
"parent_id": "11e95f8ec39de8fbdb0a4f1a",
"show_contact_notes": true,
"show_contact_files": true,
"ticket_hash_key": "A5F443CADF4AE34BBCAADF4"
},
"user": {
"account_number": "5454545454545454",
"branding_domain_url": "{branding_domain_url}",
"cell_phone": "3339998822",
"company_name": "Fortis Payment Systems, LLC",
"contact_id": "11e95f8ec39de8fbdb0a4f1a",
"date_of_birth": "2021-12-01",
"domain_id": "11e95f8ec39de8fbdb0a4f1a",
"email": "[email protected]",
"email_trx_receipt": true,
"home_phone": "3339998822",
"first_name": "John",
"last_name": "Smith",
"locale": "en-US",
"office_phone": "3339998822",
"office_ext_phone": "5",
"primary_location_id": "11e95f8ec39de8fbdb0a4f1a",
"requires_new_password": null,
"terms_condition_code": "20220308",
"tz": "America/New_York",
"ui_prefs": {
"entry_page": "dashboard",
"page_size": 2,
"report_export_type": "csv",
"process_method": "virtual_terminal",
"default_terminal": "11e95f8ec39de8fbdb0a4f1a"
},
"username": "{user_name}",
"user_api_key": "234bas8dfn8238f923w2",
"user_hash_key": null,
"user_type_code": 100,
"password": null,
"zip": "48375",
"location_id": "11e95f8ec39de8fbdb0a4f1a",
"status_id": 1,
"api_only": false,
"is_invitation": false,
"address": {
"city": "Novi",
"state": "MI",
"postal_code": "48375",
"country": "US"
},
"id": "11e95f8ec39de8fbdb0a4f1a",
"status": true,
"login_attempts": 0,
"last_login_ts": 1422040992,
"created_ts": 1422040992,
"modified_ts": 1422040992,
"created_user_id": "11e95f8ec39de8fbdb0a4f1a",
"terms_accepted_ts": 1422040992,
"terms_agree_ip": "192.168.0.10",
"current_date_time": "2019-03-11T10:38:26-0700"
},
"recurrings": [
{
"account_vault_id": "11e95f8ec39de8fbdb0a4f1a",
"token_id": "11e95f8ec39de8fbdb0a4f1a",
"account_vault_api_id": "token1234abcd",
"token_api_id": "token1234abcd",
"_joi": {
"conditions": {}
},
"active": true,
"description": "Description",
"end_date": "2021-12-01",
"installment_total_count": 20,
"interval": 1,
"interval_type": "d",
"location_id": "11e95f8ec39de8fbdb0a4f1a",
"notification_days": 2,
"payment_method": "cc",
"product_transaction_id": "11e95f8ec39de8fbdb0a4f1a",
"recurring_id": "11e95f8ec39de8fbdb0a4f1a",
"recurring_api_id": "recurring1234abcd",
"start_date": "2021-12-01",
"status": "active",
"transaction_amount": 300,
"terms_agree": true,
"terms_agree_ip": "192.168.0.10",
"recurring_c1": "recurring custom data 1",
"recurring_c2": "recurring custom data 2",
"recurring_c3": "recurring custom data 3",
"send_to_proc_as_recur": true,
"id": "11e95f8ec39de8fbdb0a4f1a",
"next_run_date": "2021-12-01",
"created_ts": 1422040992,
"modified_ts": 1422040992,
"recurring_type_id": "i",
"installment_amount_total": 99999999
}
],
"email_blacklist": {
"id": "11e95f8ec39de8fbdb0a4f1a",
"isBlacklisted": true,
"detail": true,
"created_ts": 1422040992
},
"sms_blacklist": {
"id": "11e95f8ec39de8fbdb0a4f1a",
"isBlacklisted": true,
"detail": true,
"created_ts": 1422040992
},
"changelogs": [
{
"id": "11e95f8ec39de8fbdb0a4f1a",
"created_ts": 1422040992,
"action": "CREATE",
"model": "TransactionRequest",
"model_id": "11ec829598f0d4008be9aba4",
"user_id": "11e95f8ec39de8fbdb0a4f1a",
"changelog_details": [
{
"id": "11e95f8ec39de8fbdb0a4f1a",
"changelog_id": "11e95f8ec39de8fbdb0a4f1a",
"field": "next_run_ts",
"old_value": "1643616000"
}
],
"user": {
"id": "11e95f8ec39de8fbdb0a4f1a",
"username": "[email protected]",
"first_name": "Bob",
"last_name": "Fairview"
}
}
],
"postback_logs": [
{
"id": "11e95f8ec39de8fbdb0a4f1a",
"postback_config_id": "11e95f8ec39de8fbdb0a4f1a",
"changelog_id": "11e95f8ec39de8fbdb0a4f1a",
"next_run_ts": 1422040992,
"created_ts": 1422040992,
"model_id": "11e95f8ec39de8fbdb0a4f1a"
}
],
"created_user": {
"account_number": "5454545454545454",
"branding_domain_url": "{branding_domain_url}",
"cell_phone": "3339998822",
"company_name": "Fortis Payment Systems, LLC",
"contact_id": "11e95f8ec39de8fbdb0a4f1a",
"date_of_birth": "2021-12-01",
"domain_id": "11e95f8ec39de8fbdb0a4f1a",
"email": "[email protected]",
"email_trx_receipt": true,
"home_phone": "3339998822",
"first_name": "John",
"last_name": "Smith",
"locale": "en-US",
"office_phone": "3339998822",
"office_ext_phone": "5",
"primary_location_id": "11e95f8ec39de8fbdb0a4f1a",
"requires_new_password": null,
"terms_condition_code": "20220308",
"tz": "America/New_York",
"ui_prefs": {
"entry_page": "dashboard",
"page_size": 2,
"report_export_type": "csv",
"process_method": "virtual_terminal",
"default_terminal": "11e95f8ec39de8fbdb0a4f1a"
},
"username": "{user_name}",
"user_api_key": "234bas8dfn8238f923w2",
"user_hash_key": null,
"user_type_code": 100,
"password": null,
"zip": "48375",
"location_id": "11e95f8ec39de8fbdb0a4f1a",
"status_id": 1,
"api_only": false,
"is_invitation": false,
"address": {
"city": "Novi",
"state": "MI",
"postal_code": "48375",
"country": "US"
},
"id": "11e95f8ec39de8fbdb0a4f1a",
"status": true,
"login_attempts": 0,
"last_login_ts": 1422040992,
"created_ts": 1422040992,
"modified_ts": 1422040992,
"created_user_id": "11e95f8ec39de8fbdb0a4f1a",
"terms_accepted_ts": 1422040992,
"terms_agree_ip": "192.168.0.10",
"current_date_time": "2019-03-11T10:38:26-0700"
},
"parent": {
"location_id": "11e95f8ec39de8fbdb0a4f1a",
"account_number": "54545433332",
"contact_api_id": "137",
"first_name": "John",
"last_name": "Smith",
"cell_phone": "3339998822",
"balance": 245.36,
"address": {
"city": "Novi",
"state": "Michigan",
"postal_code": "48375",
"country": "US"
},
"company_name": "Fortis Payment Systems, LLC",
"header_message": "This is a sample message for you",
"date_of_birth": "2021-12-01",
"email_trx_receipt": true,
"home_phone": "3339998822",
"office_phone": "3339998822",
"office_phone_ext": "5",
"header_message_type": 0,
"update_if_exists": 1,
"contact_c1": "any",
"contact_c2": "anything",
"contact_c3": "something",
"parent_id": "11e95f8ec39de8fbdb0a4f1a",
"email": "[email protected]",
"id": "11e95f8ec39de8fbdb0a4f1a",
"created_ts": 1422040992,
"modified_ts": 1422040992,
"active": true
},
"children": {
"location_id": "11e95f8ec39de8fbdb0a4f1a",
"account_number": "54545433332",
"contact_api_id": "137",
"first_name": "John",
"last_name": "Smith",
"cell_phone": "3339998822",
"balance": 245.36,
"address": {
"city": "Novi",
"state": "Michigan",
"postal_code": "48375",
"country": "US"
},
"company_name": "Fortis Payment Systems, LLC",
"header_message": "This is a sample message for you",
"date_of_birth": "2021-12-01",
"email_trx_receipt": true,
"home_phone": "3339998822",
"office_phone": "3339998822",
"office_phone_ext": "5",
"header_message_type": 0,
"update_if_exists": 1,
"contact_c1": "any",
"contact_c2": "anything",
"contact_c3": "something",
"parent_id": "11e95f8ec39de8fbdb0a4f1a",
"email": "[email protected]",
"id": "11e95f8ec39de8fbdb0a4f1a",
"created_ts": 1422040992,
"modified_ts": 1422040992,
"active": true
}
}
}| HTTP Status Code | Error Description | Exception Class |
|---|---|---|
| 401 | Unauthorized | Response401tokenException |
| 412 | Precondition Failed | Response412Exception |
List all Contacts
function listAllContacts(
?Page $page = null,
?Sort17 $sort = null,
?Filter1 $filter = null,
?array $expand = null
): ResponseContactsCollection| Parameter | Type | Tags | Description |
|---|---|---|---|
page |
?Page |
Query, Optional | Use this field to specify paginate your results, by using page size and number. You can use one of the following methods: > /endpoint?page={ "number": 1, "size": 50 } > > /endpoint?page[number]=1&page[size]=50 |
sort |
?Sort17 |
Query, Optional | You can use any field_name from this endpoint results, and you can combine more than one field for more complex sorting. You can use one of the following methods:> /endpoint?sort={ "field_name": "asc", "field_name2": "desc" } > > /endpoint?sort[field_name]=asc&sort[field_name2]=desc |
filter |
?Filter1 |
Query, Optional | You can use any field_name from this endpoint results as a filter, and you can also use more than one field to create AND conditions. For date fields (ended with _ts), you can also search for ranges using the $gte (Greater than or equal to) and/or $lte (Lower than or equal to). You can use one of the following methods:> /endpoint?filter={ "field_name": "Value" } > > /endpoint?filter[field_name]=Value > > /endpoint?filter={ "created_ts": "today" } > > /endpoint?filter[created_ts]=today > > /endpoint?filter={ "created_ts": { "$gte": "yesterday", "$lte": "today" } } > > /endpoint?filter[created_ts][$gte]=yesterday&filter[created_ts][$lte]=today > > /endpoint?filter[address][city]=memphis > > /endpoint?filter={ "address": { "city" : "memphis" } } |
expand |
?(string[]) (Expand1Enum) |
Query, Optional | Most endpoints in the API have a way to retrieve extra data related to the current record being retrieved. For example, if the API request is for the accountvaults endpoint, and the end user also needs to know which contact the token belongs to, this data can be returned in the accountvaults endpoint request. Constraints: Unique Items Required, Pattern: ^[\w]+$ |
$page = PageBuilder::init()
->number(1)
->size(50)
->build();
$result = $contactsController->listAllContacts($page);{
"type": "ContactsCollection",
"list": [
{
"location_id": "11e95f8ec39de8fbdb0a4f1a",
"account_number": "54545433332",
"contact_api_id": "137",
"first_name": "John",
"last_name": "Smith",
"cell_phone": "3339998822",
"balance": 245.36,
"address": {
"city": "Novi",
"state": "Michigan",
"postal_code": "48375",
"country": "US"
},
"company_name": "Fortis Payment Systems, LLC",
"header_message": "This is a sample message for you",
"date_of_birth": "2021-12-01",
"email_trx_receipt": true,
"home_phone": "3339998822",
"office_phone": "3339998822",
"office_phone_ext": "5",
"header_message_type": 0,
"update_if_exists": 1,
"contact_c1": "any",
"contact_c2": "anything",
"contact_c3": "something",
"parent_id": "11e95f8ec39de8fbdb0a4f1a",
"email": "[email protected]",
"id": "11e95f8ec39de8fbdb0a4f1a",
"created_ts": 1422040992,
"modified_ts": 1422040992,
"active": true,
"received_emails": [
{
"subject": "Payment Receipt - 12skiestech",
"body": "This email is being sent from a server.",
"source_address": "\"12skiestech A7t3qi\" <[email protected]>",
"return_path": "\"12skiestech A7t3qi\" <[email protected]>",
"provider_id": "0100017e67bcc530-e1dd23b4-8a39-4a5b-8d5d-68d51c4c942f-000000",
"domain_id": "11e95f8ec39de8fbdb0a4f1a",
"reason_sent": "Contact Email",
"reason_model": "Transaction",
"reason_model_id": "11e95f8ec39de8fbdb0a4f1a",
"reply_to": "\"Zeamster\" <[email protected]>",
"id": "11e95f8ec39de8fbdb0a4f1a",
"created_ts": 1422040992
}
],
"is_deletable": true,
"location": {
"id": "11e95f8ec39de8fbdb0a4f1a",
"created_ts": 1422040992,
"modified_ts": 1422040992,
"account_number": "5454545454545454",
"address": {
"city": "Novi",
"state": "MI",
"postal_code": "48375",
"country": "US"
},
"branding_domain_id": "11e95f8ec39de8fbdb0a4f1a",
"contact_email_trx_receipt_default": true,
"default_ach": "11e608a7d515f1e093242bb2",
"default_cc": "11e608a442a5f1e092242dda",
"email_reply_to": "[email protected]",
"fax": "3339998822",
"location_api_id": "location-111111",
"location_api_key": "AE34BBCAADF4AE34BBCAADF4",
"location_c1": "custom 1",
"location_c2": "custom 2",
"location_c3": "custom data 3",
"name": "Sample Company Headquarters",
"office_phone": "2481234567",
"office_ext_phone": "1021021209",
"tz": "America/New_York",
"parent_id": "11e95f8ec39de8fbdb0a4f1a",
"show_contact_notes": true,
"show_contact_files": true,
"ticket_hash_key": "A5F443CADF4AE34BBCAADF4"
},
"user": {
"account_number": "5454545454545454",
"branding_domain_url": "{branding_domain_url}",
"cell_phone": "3339998822",
"company_name": "Fortis Payment Systems, LLC",
"contact_id": "11e95f8ec39de8fbdb0a4f1a",
"date_of_birth": "2021-12-01",
"domain_id": "11e95f8ec39de8fbdb0a4f1a",
"email": "[email protected]",
"email_trx_receipt": true,
"home_phone": "3339998822",
"first_name": "John",
"last_name": "Smith",
"locale": "en-US",
"office_phone": "3339998822",
"office_ext_phone": "5",
"primary_location_id": "11e95f8ec39de8fbdb0a4f1a",
"requires_new_password": null,
"terms_condition_code": "20220308",
"tz": "America/New_York",
"ui_prefs": {
"entry_page": "dashboard",
"page_size": 2,
"report_export_type": "csv",
"process_method": "virtual_terminal",
"default_terminal": "11e95f8ec39de8fbdb0a4f1a"
},
"username": "{user_name}",
"user_api_key": "234bas8dfn8238f923w2",
"user_hash_key": null,
"user_type_code": 100,
"password": null,
"zip": "48375",
"location_id": "11e95f8ec39de8fbdb0a4f1a",
"status_id": 1,
"api_only": false,
"is_invitation": false,
"address": {
"city": "Novi",
"state": "MI",
"postal_code": "48375",
"country": "US"
},
"id": "11e95f8ec39de8fbdb0a4f1a",
"status": true,
"login_attempts": 0,
"last_login_ts": 1422040992,
"created_ts": 1422040992,
"modified_ts": 1422040992,
"created_user_id": "11e95f8ec39de8fbdb0a4f1a",
"terms_accepted_ts": 1422040992,
"terms_agree_ip": "192.168.0.10",
"current_date_time": "2019-03-11T10:38:26-0700"
},
"recurrings": [
{
"account_vault_id": "11e95f8ec39de8fbdb0a4f1a",
"token_id": "11e95f8ec39de8fbdb0a4f1a",
"account_vault_api_id": "token1234abcd",
"token_api_id": "token1234abcd",
"_joi": {
"conditions": {}
},
"active": true,
"description": "Description",
"end_date": "2021-12-01",
"installment_total_count": 20,
"interval": 1,
"interval_type": "d",
"location_id": "11e95f8ec39de8fbdb0a4f1a",
"notification_days": 2,
"payment_method": "cc",
"product_transaction_id": "11e95f8ec39de8fbdb0a4f1a",
"recurring_id": "11e95f8ec39de8fbdb0a4f1a",
"recurring_api_id": "recurring1234abcd",
"start_date": "2021-12-01",
"status": "active",
"transaction_amount": 300,
"terms_agree": true,
"terms_agree_ip": "192.168.0.10",
"recurring_c1": "recurring custom data 1",
"recurring_c2": "recurring custom data 2",
"recurring_c3": "recurring custom data 3",
"send_to_proc_as_recur": true,
"id": "11e95f8ec39de8fbdb0a4f1a",
"next_run_date": "2021-12-01",
"created_ts": 1422040992,
"modified_ts": 1422040992,
"recurring_type_id": "i",
"installment_amount_total": 99999999
}
],
"email_blacklist": {
"id": "11e95f8ec39de8fbdb0a4f1a",
"isBlacklisted": true,
"detail": true,
"created_ts": 1422040992
},
"sms_blacklist": {
"id": "11e95f8ec39de8fbdb0a4f1a",
"isBlacklisted": true,
"detail": true,
"created_ts": 1422040992
},
"changelogs": [
{
"id": "11e95f8ec39de8fbdb0a4f1a",
"created_ts": 1422040992,
"action": "CREATE",
"model": "TransactionRequest",
"model_id": "11ec829598f0d4008be9aba4",
"user_id": "11e95f8ec39de8fbdb0a4f1a",
"changelog_details": [
{
"id": "11e95f8ec39de8fbdb0a4f1a",
"changelog_id": "11e95f8ec39de8fbdb0a4f1a",
"field": "next_run_ts",
"old_value": "1643616000"
}
],
"user": {
"id": "11e95f8ec39de8fbdb0a4f1a",
"username": "[email protected]",
"first_name": "Bob",
"last_name": "Fairview"
}
}
],
"postback_logs": [
{
"id": "11e95f8ec39de8fbdb0a4f1a",
"postback_config_id": "11e95f8ec39de8fbdb0a4f1a",
"changelog_id": "11e95f8ec39de8fbdb0a4f1a",
"next_run_ts": 1422040992,
"created_ts": 1422040992,
"model_id": "11e95f8ec39de8fbdb0a4f1a"
}
],
"created_user": {
"account_number": "5454545454545454",
"branding_domain_url": "{branding_domain_url}",
"cell_phone": "3339998822",
"company_name": "Fortis Payment Systems, LLC",
"contact_id": "11e95f8ec39de8fbdb0a4f1a",
"date_of_birth": "2021-12-01",
"domain_id": "11e95f8ec39de8fbdb0a4f1a",
"email": "[email protected]",
"email_trx_receipt": true,
"home_phone": "3339998822",
"first_name": "John",
"last_name": "Smith",
"locale": "en-US",
"office_phone": "3339998822",
"office_ext_phone": "5",
"primary_location_id": "11e95f8ec39de8fbdb0a4f1a",
"requires_new_password": null,
"terms_condition_code": "20220308",
"tz": "America/New_York",
"ui_prefs": {
"entry_page": "dashboard",
"page_size": 2,
"report_export_type": "csv",
"process_method": "virtual_terminal",
"default_terminal": "11e95f8ec39de8fbdb0a4f1a"
},
"username": "{user_name}",
"user_api_key": "234bas8dfn8238f923w2",
"user_hash_key": null,
"user_type_code": 100,
"password": null,
"zip": "48375",
"location_id": "11e95f8ec39de8fbdb0a4f1a",
"status_id": 1,
"api_only": false,
"is_invitation": false,
"address": {
"city": "Novi",
"state": "MI",
"postal_code": "48375",
"country": "US"
},
"id": "11e95f8ec39de8fbdb0a4f1a",
"status": true,
"login_attempts": 0,
"last_login_ts": 1422040992,
"created_ts": 1422040992,
"modified_ts": 1422040992,
"created_user_id": "11e95f8ec39de8fbdb0a4f1a",
"terms_accepted_ts": 1422040992,
"terms_agree_ip": "192.168.0.10",
"current_date_time": "2019-03-11T10:38:26-0700"
},
"parent": {
"location_id": "11e95f8ec39de8fbdb0a4f1a",
"account_number": "54545433332",
"contact_api_id": "137",
"first_name": "John",
"last_name": "Smith",
"cell_phone": "3339998822",
"balance": 245.36,
"address": {
"city": "Novi",
"state": "Michigan",
"postal_code": "48375",
"country": "US"
},
"company_name": "Fortis Payment Systems, LLC",
"header_message": "This is a sample message for you",
"date_of_birth": "2021-12-01",
"email_trx_receipt": true,
"home_phone": "3339998822",
"office_phone": "3339998822",
"office_phone_ext": "5",
"header_message_type": 0,
"update_if_exists": 1,
"contact_c1": "any",
"contact_c2": "anything",
"contact_c3": "something",
"parent_id": "11e95f8ec39de8fbdb0a4f1a",
"email": "[email protected]",
"id": "11e95f8ec39de8fbdb0a4f1a",
"created_ts": 1422040992,
"modified_ts": 1422040992,
"active": true
},
"children": {
"location_id": "11e95f8ec39de8fbdb0a4f1a",
"account_number": "54545433332",
"contact_api_id": "137",
"first_name": "John",
"last_name": "Smith",
"cell_phone": "3339998822",
"balance": 245.36,
"address": {
"city": "Novi",
"state": "Michigan",
"postal_code": "48375",
"country": "US"
},
"company_name": "Fortis Payment Systems, LLC",
"header_message": "This is a sample message for you",
"date_of_birth": "2021-12-01",
"email_trx_receipt": true,
"home_phone": "3339998822",
"office_phone": "3339998822",
"office_phone_ext": "5",
"header_message_type": 0,
"update_if_exists": 1,
"contact_c1": "any",
"contact_c2": "anything",
"contact_c3": "something",
"parent_id": "11e95f8ec39de8fbdb0a4f1a",
"email": "[email protected]",
"id": "11e95f8ec39de8fbdb0a4f1a",
"created_ts": 1422040992,
"modified_ts": 1422040992,
"active": true
}
}
],
"links": {
"type": "Links",
"first": "/v1/endpoint?page[size]=10&page[number]=1",
"previous": "/v1/endpoint?page[size]=10&page[number]=5",
"last": "/v1/endpoint?page[size]=10&page[number]=42"
},
"pagination": {
"type": "Pagination",
"total_count": 423,
"page_count": 42,
"page_number": 6,
"page_size": 10
},
"sort": {
"type": "Sorting",
"fields": [
{
"field": "last_name",
"order": "asc"
}
]
}
}| HTTP Status Code | Error Description | Exception Class |
|---|---|---|
| 401 | Unauthorized | Response401tokenException |
Delete Contact
function deleteContact(string $contactId): ResponseContact| Parameter | Type | Tags | Description |
|---|---|---|---|
contactId |
string |
Template, Required | Contact ID Constraints: Pattern: ^(([0-9a-fA-F\-]{24,36})|(([0-9a-fA-F]{8})-(([0-9a-fA-F]{4}\-){3})([0-9a-fA-F]{12})))$ |
$contactId = '11e95f8ec39de8fbdb0a4f1a';
$result = $contactsController->deleteContact($contactId);{
"type": "Contact",
"data": {
"location_id": "11e95f8ec39de8fbdb0a4f1a",
"account_number": "54545433332",
"contact_api_id": "137",
"first_name": "John",
"last_name": "Smith",
"cell_phone": "3339998822",
"balance": 245.36,
"address": {
"city": "Novi",
"state": "Michigan",
"postal_code": "48375",
"country": "US"
},
"company_name": "Fortis Payment Systems, LLC",
"header_message": "This is a sample message for you",
"date_of_birth": "2021-12-01",
"email_trx_receipt": true,
"home_phone": "3339998822",
"office_phone": "3339998822",
"office_phone_ext": "5",
"header_message_type": 0,
"update_if_exists": 1,
"contact_c1": "any",
"contact_c2": "anything",
"contact_c3": "something",
"parent_id": "11e95f8ec39de8fbdb0a4f1a",
"email": "[email protected]",
"id": "11e95f8ec39de8fbdb0a4f1a",
"created_ts": 1422040992,
"modified_ts": 1422040992,
"active": true,
"received_emails": [
{
"subject": "Payment Receipt - 12skiestech",
"body": "This email is being sent from a server.",
"source_address": "\"12skiestech A7t3qi\" <[email protected]>",
"return_path": "\"12skiestech A7t3qi\" <[email protected]>",
"provider_id": "0100017e67bcc530-e1dd23b4-8a39-4a5b-8d5d-68d51c4c942f-000000",
"domain_id": "11e95f8ec39de8fbdb0a4f1a",
"reason_sent": "Contact Email",
"reason_model": "Transaction",
"reason_model_id": "11e95f8ec39de8fbdb0a4f1a",
"reply_to": "\"Zeamster\" <[email protected]>",
"id": "11e95f8ec39de8fbdb0a4f1a",
"created_ts": 1422040992
}
],
"is_deletable": true,
"location": {
"id": "11e95f8ec39de8fbdb0a4f1a",
"created_ts": 1422040992,
"modified_ts": 1422040992,
"account_number": "5454545454545454",
"address": {
"city": "Novi",
"state": "MI",
"postal_code": "48375",
"country": "US"
},
"branding_domain_id": "11e95f8ec39de8fbdb0a4f1a",
"contact_email_trx_receipt_default": true,
"default_ach": "11e608a7d515f1e093242bb2",
"default_cc": "11e608a442a5f1e092242dda",
"email_reply_to": "[email protected]",
"fax": "3339998822",
"location_api_id": "location-111111",
"location_api_key": "AE34BBCAADF4AE34BBCAADF4",
"location_c1": "custom 1",
"location_c2": "custom 2",
"location_c3": "custom data 3",
"name": "Sample Company Headquarters",
"office_phone": "2481234567",
"office_ext_phone": "1021021209",
"tz": "America/New_York",
"parent_id": "11e95f8ec39de8fbdb0a4f1a",
"show_contact_notes": true,
"show_contact_files": true,
"ticket_hash_key": "A5F443CADF4AE34BBCAADF4"
},
"user": {
"account_number": "5454545454545454",
"branding_domain_url": "{branding_domain_url}",
"cell_phone": "3339998822",
"company_name": "Fortis Payment Systems, LLC",
"contact_id": "11e95f8ec39de8fbdb0a4f1a",
"date_of_birth": "2021-12-01",
"domain_id": "11e95f8ec39de8fbdb0a4f1a",
"email": "[email protected]",
"email_trx_receipt": true,
"home_phone": "3339998822",
"first_name": "John",
"last_name": "Smith",
"locale": "en-US",
"office_phone": "3339998822",
"office_ext_phone": "5",
"primary_location_id": "11e95f8ec39de8fbdb0a4f1a",
"requires_new_password": null,
"terms_condition_code": "20220308",
"tz": "America/New_York",
"ui_prefs": {
"entry_page": "dashboard",
"page_size": 2,
"report_export_type": "csv",
"process_method": "virtual_terminal",
"default_terminal": "11e95f8ec39de8fbdb0a4f1a"
},
"username": "{user_name}",
"user_api_key": "234bas8dfn8238f923w2",
"user_hash_key": null,
"user_type_code": 100,
"password": null,
"zip": "48375",
"location_id": "11e95f8ec39de8fbdb0a4f1a",
"status_id": 1,
"api_only": false,
"is_invitation": false,
"address": {
"city": "Novi",
"state": "MI",
"postal_code": "48375",
"country": "US"
},
"id": "11e95f8ec39de8fbdb0a4f1a",
"status": true,
"login_attempts": 0,
"last_login_ts": 1422040992,
"created_ts": 1422040992,
"modified_ts": 1422040992,
"created_user_id": "11e95f8ec39de8fbdb0a4f1a",
"terms_accepted_ts": 1422040992,
"terms_agree_ip": "192.168.0.10",
"current_date_time": "2019-03-11T10:38:26-0700"
},
"recurrings": [
{
"account_vault_id": "11e95f8ec39de8fbdb0a4f1a",
"token_id": "11e95f8ec39de8fbdb0a4f1a",
"account_vault_api_id": "token1234abcd",
"token_api_id": "token1234abcd",
"_joi": {
"conditions": {}
},
"active": true,
"description": "Description",
"end_date": "2021-12-01",
"installment_total_count": 20,
"interval": 1,
"interval_type": "d",
"location_id": "11e95f8ec39de8fbdb0a4f1a",
"notification_days": 2,
"payment_method": "cc",
"product_transaction_id": "11e95f8ec39de8fbdb0a4f1a",
"recurring_id": "11e95f8ec39de8fbdb0a4f1a",
"recurring_api_id": "recurring1234abcd",
"start_date": "2021-12-01",
"status": "active",
"transaction_amount": 300,
"terms_agree": true,
"terms_agree_ip": "192.168.0.10",
"recurring_c1": "recurring custom data 1",
"recurring_c2": "recurring custom data 2",
"recurring_c3": "recurring custom data 3",
"send_to_proc_as_recur": true,
"id": "11e95f8ec39de8fbdb0a4f1a",
"next_run_date": "2021-12-01",
"created_ts": 1422040992,
"modified_ts": 1422040992,
"recurring_type_id": "i",
"installment_amount_total": 99999999
}
],
"email_blacklist": {
"id": "11e95f8ec39de8fbdb0a4f1a",
"isBlacklisted": true,
"detail": true,
"created_ts": 1422040992
},
"sms_blacklist": {
"id": "11e95f8ec39de8fbdb0a4f1a",
"isBlacklisted": true,
"detail": true,
"created_ts": 1422040992
},
"changelogs": [
{
"id": "11e95f8ec39de8fbdb0a4f1a",
"created_ts": 1422040992,
"action": "CREATE",
"model": "TransactionRequest",
"model_id": "11ec829598f0d4008be9aba4",
"user_id": "11e95f8ec39de8fbdb0a4f1a",
"changelog_details": [
{
"id": "11e95f8ec39de8fbdb0a4f1a",
"changelog_id": "11e95f8ec39de8fbdb0a4f1a",
"field": "next_run_ts",
"old_value": "1643616000"
}
],
"user": {
"id": "11e95f8ec39de8fbdb0a4f1a",
"username": "[email protected]",
"first_name": "Bob",
"last_name": "Fairview"
}
}
],
"postback_logs": [
{
"id": "11e95f8ec39de8fbdb0a4f1a",
"postback_config_id": "11e95f8ec39de8fbdb0a4f1a",
"changelog_id": "11e95f8ec39de8fbdb0a4f1a",
"next_run_ts": 1422040992,
"created_ts": 1422040992,
"model_id": "11e95f8ec39de8fbdb0a4f1a"
}
],
"created_user": {
"account_number": "5454545454545454",
"branding_domain_url": "{branding_domain_url}",
"cell_phone": "3339998822",
"company_name": "Fortis Payment Systems, LLC",
"contact_id": "11e95f8ec39de8fbdb0a4f1a",
"date_of_birth": "2021-12-01",
"domain_id": "11e95f8ec39de8fbdb0a4f1a",
"email": "[email protected]",
"email_trx_receipt": true,
"home_phone": "3339998822",
"first_name": "John",
"last_name": "Smith",
"locale": "en-US",
"office_phone": "3339998822",
"office_ext_phone": "5",
"primary_location_id": "11e95f8ec39de8fbdb0a4f1a",
"requires_new_password": null,
"terms_condition_code": "20220308",
"tz": "America/New_York",
"ui_prefs": {
"entry_page": "dashboard",
"page_size": 2,
"report_export_type": "csv",
"process_method": "virtual_terminal",
"default_terminal": "11e95f8ec39de8fbdb0a4f1a"
},
"username": "{user_name}",
"user_api_key": "234bas8dfn8238f923w2",
"user_hash_key": null,
"user_type_code": 100,
"password": null,
"zip": "48375",
"location_id": "11e95f8ec39de8fbdb0a4f1a",
"status_id": 1,
"api_only": false,
"is_invitation": false,
"address": {
"city": "Novi",
"state": "MI",
"postal_code": "48375",
"country": "US"
},
"id": "11e95f8ec39de8fbdb0a4f1a",
"status": true,
"login_attempts": 0,
"last_login_ts": 1422040992,
"created_ts": 1422040992,
"modified_ts": 1422040992,
"created_user_id": "11e95f8ec39de8fbdb0a4f1a",
"terms_accepted_ts": 1422040992,
"terms_agree_ip": "192.168.0.10",
"current_date_time": "2019-03-11T10:38:26-0700"
},
"parent": {
"location_id": "11e95f8ec39de8fbdb0a4f1a",
"account_number": "54545433332",
"contact_api_id": "137",
"first_name": "John",
"last_name": "Smith",
"cell_phone": "3339998822",
"balance": 245.36,
"address": {
"city": "Novi",
"state": "Michigan",
"postal_code": "48375",
"country": "US"
},
"company_name": "Fortis Payment Systems, LLC",
"header_message": "This is a sample message for you",
"date_of_birth": "2021-12-01",
"email_trx_receipt": true,
"home_phone": "3339998822",
"office_phone": "3339998822",
"office_phone_ext": "5",
"header_message_type": 0,
"update_if_exists": 1,
"contact_c1": "any",
"contact_c2": "anything",
"contact_c3": "something",
"parent_id": "11e95f8ec39de8fbdb0a4f1a",
"email": "[email protected]",
"id": "11e95f8ec39de8fbdb0a4f1a",
"created_ts": 1422040992,
"modified_ts": 1422040992,
"active": true
},
"children": {
"location_id": "11e95f8ec39de8fbdb0a4f1a",
"account_number": "54545433332",
"contact_api_id": "137",
"first_name": "John",
"last_name": "Smith",
"cell_phone": "3339998822",
"balance": 245.36,
"address": {
"city": "Novi",
"state": "Michigan",
"postal_code": "48375",
"country": "US"
},
"company_name": "Fortis Payment Systems, LLC",
"header_message": "This is a sample message for you",
"date_of_birth": "2021-12-01",
"email_trx_receipt": true,
"home_phone": "3339998822",
"office_phone": "3339998822",
"office_phone_ext": "5",
"header_message_type": 0,
"update_if_exists": 1,
"contact_c1": "any",
"contact_c2": "anything",
"contact_c3": "something",
"parent_id": "11e95f8ec39de8fbdb0a4f1a",
"email": "[email protected]",
"id": "11e95f8ec39de8fbdb0a4f1a",
"created_ts": 1422040992,
"modified_ts": 1422040992,
"active": true
}
}
}| HTTP Status Code | Error Description | Exception Class |
|---|---|---|
| 401 | Unauthorized | Response401tokenException |
View Single Contact
function viewSingleContact(string $contactId, ?array $expand = null): ResponseContact| Parameter | Type | Tags | Description |
|---|---|---|---|
contactId |
string |
Template, Required | Contact ID Constraints: Pattern: ^(([0-9a-fA-F\-]{24,36})|(([0-9a-fA-F]{8})-(([0-9a-fA-F]{4}\-){3})([0-9a-fA-F]{12})))$ |
expand |
?(string[]) (Expand1Enum) |
Query, Optional | Most endpoints in the API have a way to retrieve extra data related to the current record being retrieved. For example, if the API request is for the accountvaults endpoint, and the end user also needs to know which contact the token belongs to, this data can be returned in the accountvaults endpoint request. Constraints: Unique Items Required, Pattern: ^[\w]+$ |
$contactId = '11e95f8ec39de8fbdb0a4f1a';
$result = $contactsController->viewSingleContact($contactId);{
"type": "Contact",
"data": {
"location_id": "11e95f8ec39de8fbdb0a4f1a",
"account_number": "54545433332",
"contact_api_id": "137",
"first_name": "John",
"last_name": "Smith",
"cell_phone": "3339998822",
"balance": 245.36,
"address": {
"city": "Novi",
"state": "Michigan",
"postal_code": "48375",
"country": "US"
},
"company_name": "Fortis Payment Systems, LLC",
"header_message": "This is a sample message for you",
"date_of_birth": "2021-12-01",
"email_trx_receipt": true,
"home_phone": "3339998822",
"office_phone": "3339998822",
"office_phone_ext": "5",
"header_message_type": 0,
"update_if_exists": 1,
"contact_c1": "any",
"contact_c2": "anything",
"contact_c3": "something",
"parent_id": "11e95f8ec39de8fbdb0a4f1a",
"email": "[email protected]",
"id": "11e95f8ec39de8fbdb0a4f1a",
"created_ts": 1422040992,
"modified_ts": 1422040992,
"active": true,
"received_emails": [
{
"subject": "Payment Receipt - 12skiestech",
"body": "This email is being sent from a server.",
"source_address": "\"12skiestech A7t3qi\" <[email protected]>",
"return_path": "\"12skiestech A7t3qi\" <[email protected]>",
"provider_id": "0100017e67bcc530-e1dd23b4-8a39-4a5b-8d5d-68d51c4c942f-000000",
"domain_id": "11e95f8ec39de8fbdb0a4f1a",
"reason_sent": "Contact Email",
"reason_model": "Transaction",
"reason_model_id": "11e95f8ec39de8fbdb0a4f1a",
"reply_to": "\"Zeamster\" <[email protected]>",
"id": "11e95f8ec39de8fbdb0a4f1a",
"created_ts": 1422040992
}
],
"is_deletable": true,
"location": {
"id": "11e95f8ec39de8fbdb0a4f1a",
"created_ts": 1422040992,
"modified_ts": 1422040992,
"account_number": "5454545454545454",
"address": {
"city": "Novi",
"state": "MI",
"postal_code": "48375",
"country": "US"
},
"branding_domain_id": "11e95f8ec39de8fbdb0a4f1a",
"contact_email_trx_receipt_default": true,
"default_ach": "11e608a7d515f1e093242bb2",
"default_cc": "11e608a442a5f1e092242dda",
"email_reply_to": "[email protected]",
"fax": "3339998822",
"location_api_id": "location-111111",
"location_api_key": "AE34BBCAADF4AE34BBCAADF4",
"location_c1": "custom 1",
"location_c2": "custom 2",
"location_c3": "custom data 3",
"name": "Sample Company Headquarters",
"office_phone": "2481234567",
"office_ext_phone": "1021021209",
"tz": "America/New_York",
"parent_id": "11e95f8ec39de8fbdb0a4f1a",
"show_contact_notes": true,
"show_contact_files": true,
"ticket_hash_key": "A5F443CADF4AE34BBCAADF4"
},
"user": {
"account_number": "5454545454545454",
"branding_domain_url": "{branding_domain_url}",
"cell_phone": "3339998822",
"company_name": "Fortis Payment Systems, LLC",
"contact_id": "11e95f8ec39de8fbdb0a4f1a",
"date_of_birth": "2021-12-01",
"domain_id": "11e95f8ec39de8fbdb0a4f1a",
"email": "[email protected]",
"email_trx_receipt": true,
"home_phone": "3339998822",
"first_name": "John",
"last_name": "Smith",
"locale": "en-US",
"office_phone": "3339998822",
"office_ext_phone": "5",
"primary_location_id": "11e95f8ec39de8fbdb0a4f1a",
"requires_new_password": null,
"terms_condition_code": "20220308",
"tz": "America/New_York",
"ui_prefs": {
"entry_page": "dashboard",
"page_size": 2,
"report_export_type": "csv",
"process_method": "virtual_terminal",
"default_terminal": "11e95f8ec39de8fbdb0a4f1a"
},
"username": "{user_name}",
"user_api_key": "234bas8dfn8238f923w2",
"user_hash_key": null,
"user_type_code": 100,
"password": null,
"zip": "48375",
"location_id": "11e95f8ec39de8fbdb0a4f1a",
"status_id": 1,
"api_only": false,
"is_invitation": false,
"address": {
"city": "Novi",
"state": "MI",
"postal_code": "48375",
"country": "US"
},
"id": "11e95f8ec39de8fbdb0a4f1a",
"status": true,
"login_attempts": 0,
"last_login_ts": 1422040992,
"created_ts": 1422040992,
"modified_ts": 1422040992,
"created_user_id": "11e95f8ec39de8fbdb0a4f1a",
"terms_accepted_ts": 1422040992,
"terms_agree_ip": "192.168.0.10",
"current_date_time": "2019-03-11T10:38:26-0700"
},
"recurrings": [
{
"account_vault_id": "11e95f8ec39de8fbdb0a4f1a",
"token_id": "11e95f8ec39de8fbdb0a4f1a",
"account_vault_api_id": "token1234abcd",
"token_api_id": "token1234abcd",
"_joi": {
"conditions": {}
},
"active": true,
"description": "Description",
"end_date": "2021-12-01",
"installment_total_count": 20,
"interval": 1,
"interval_type": "d",
"location_id": "11e95f8ec39de8fbdb0a4f1a",
"notification_days": 2,
"payment_method": "cc",
"product_transaction_id": "11e95f8ec39de8fbdb0a4f1a",
"recurring_id": "11e95f8ec39de8fbdb0a4f1a",
"recurring_api_id": "recurring1234abcd",
"start_date": "2021-12-01",
"status": "active",
"transaction_amount": 300,
"terms_agree": true,
"terms_agree_ip": "192.168.0.10",
"recurring_c1": "recurring custom data 1",
"recurring_c2": "recurring custom data 2",
"recurring_c3": "recurring custom data 3",
"send_to_proc_as_recur": true,
"id": "11e95f8ec39de8fbdb0a4f1a",
"next_run_date": "2021-12-01",
"created_ts": 1422040992,
"modified_ts": 1422040992,
"recurring_type_id": "i",
"installment_amount_total": 99999999
}
],
"email_blacklist": {
"id": "11e95f8ec39de8fbdb0a4f1a",
"isBlacklisted": true,
"detail": true,
"created_ts": 1422040992
},
"sms_blacklist": {
"id": "11e95f8ec39de8fbdb0a4f1a",
"isBlacklisted": true,
"detail": true,
"created_ts": 1422040992
},
"changelogs": [
{
"id": "11e95f8ec39de8fbdb0a4f1a",
"created_ts": 1422040992,
"action": "CREATE",
"model": "TransactionRequest",
"model_id": "11ec829598f0d4008be9aba4",
"user_id": "11e95f8ec39de8fbdb0a4f1a",
"changelog_details": [
{
"id": "11e95f8ec39de8fbdb0a4f1a",
"changelog_id": "11e95f8ec39de8fbdb0a4f1a",
"field": "next_run_ts",
"old_value": "1643616000"
}
],
"user": {
"id": "11e95f8ec39de8fbdb0a4f1a",
"username": "[email protected]",
"first_name": "Bob",
"last_name": "Fairview"
}
}
],
"postback_logs": [
{
"id": "11e95f8ec39de8fbdb0a4f1a",
"postback_config_id": "11e95f8ec39de8fbdb0a4f1a",
"changelog_id": "11e95f8ec39de8fbdb0a4f1a",
"next_run_ts": 1422040992,
"created_ts": 1422040992,
"model_id": "11e95f8ec39de8fbdb0a4f1a"
}
],
"created_user": {
"account_number": "5454545454545454",
"branding_domain_url": "{branding_domain_url}",
"cell_phone": "3339998822",
"company_name": "Fortis Payment Systems, LLC",
"contact_id": "11e95f8ec39de8fbdb0a4f1a",
"date_of_birth": "2021-12-01",
"domain_id": "11e95f8ec39de8fbdb0a4f1a",
"email": "[email protected]",
"email_trx_receipt": true,
"home_phone": "3339998822",
"first_name": "John",
"last_name": "Smith",
"locale": "en-US",
"office_phone": "3339998822",
"office_ext_phone": "5",
"primary_location_id": "11e95f8ec39de8fbdb0a4f1a",
"requires_new_password": null,
"terms_condition_code": "20220308",
"tz": "America/New_York",
"ui_prefs": {
"entry_page": "dashboard",
"page_size": 2,
"report_export_type": "csv",
"process_method": "virtual_terminal",
"default_terminal": "11e95f8ec39de8fbdb0a4f1a"
},
"username": "{user_name}",
"user_api_key": "234bas8dfn8238f923w2",
"user_hash_key": null,
"user_type_code": 100,
"password": null,
"zip": "48375",
"location_id": "11e95f8ec39de8fbdb0a4f1a",
"status_id": 1,
"api_only": false,
"is_invitation": false,
"address": {
"city": "Novi",
"state": "MI",
"postal_code": "48375",
"country": "US"
},
"id": "11e95f8ec39de8fbdb0a4f1a",
"status": true,
"login_attempts": 0,
"last_login_ts": 1422040992,
"created_ts": 1422040992,
"modified_ts": 1422040992,
"created_user_id": "11e95f8ec39de8fbdb0a4f1a",
"terms_accepted_ts": 1422040992,
"terms_agree_ip": "192.168.0.10",
"current_date_time": "2019-03-11T10:38:26-0700"
},
"parent": {
"location_id": "11e95f8ec39de8fbdb0a4f1a",
"account_number": "54545433332",
"contact_api_id": "137",
"first_name": "John",
"last_name": "Smith",
"cell_phone": "3339998822",
"balance": 245.36,
"address": {
"city": "Novi",
"state": "Michigan",
"postal_code": "48375",
"country": "US"
},
"company_name": "Fortis Payment Systems, LLC",
"header_message": "This is a sample message for you",
"date_of_birth": "2021-12-01",
"email_trx_receipt": true,
"home_phone": "3339998822",
"office_phone": "3339998822",
"office_phone_ext": "5",
"header_message_type": 0,
"update_if_exists": 1,
"contact_c1": "any",
"contact_c2": "anything",
"contact_c3": "something",
"parent_id": "11e95f8ec39de8fbdb0a4f1a",
"email": "[email protected]",
"id": "11e95f8ec39de8fbdb0a4f1a",
"created_ts": 1422040992,
"modified_ts": 1422040992,
"active": true
},
"children": {
"location_id": "11e95f8ec39de8fbdb0a4f1a",
"account_number": "54545433332",
"contact_api_id": "137",
"first_name": "John",
"last_name": "Smith",
"cell_phone": "3339998822",
"balance": 245.36,
"address": {
"city": "Novi",
"state": "Michigan",
"postal_code": "48375",
"country": "US"
},
"company_name": "Fortis Payment Systems, LLC",
"header_message": "This is a sample message for you",
"date_of_birth": "2021-12-01",
"email_trx_receipt": true,
"home_phone": "3339998822",
"office_phone": "3339998822",
"office_phone_ext": "5",
"header_message_type": 0,
"update_if_exists": 1,
"contact_c1": "any",
"contact_c2": "anything",
"contact_c3": "something",
"parent_id": "11e95f8ec39de8fbdb0a4f1a",
"email": "[email protected]",
"id": "11e95f8ec39de8fbdb0a4f1a",
"created_ts": 1422040992,
"modified_ts": 1422040992,
"active": true
}
}
}| HTTP Status Code | Error Description | Exception Class |
|---|---|---|
| 401 | Unauthorized | Response401tokenException |
Update Contact
function updateContact(string $contactId, V1ContactsRequest1 $body, ?array $expand = null): ResponseContact| Parameter | Type | Tags | Description |
|---|---|---|---|
contactId |
string |
Template, Required | Contact ID Constraints: Pattern: ^(([0-9a-fA-F\-]{24,36})|(([0-9a-fA-F]{8})-(([0-9a-fA-F]{4}\-){3})([0-9a-fA-F]{12})))$ |
body |
V1ContactsRequest1 |
Body, Required | - |
expand |
?(string[]) (Expand1Enum) |
Query, Optional | Most endpoints in the API have a way to retrieve extra data related to the current record being retrieved. For example, if the API request is for the accountvaults endpoint, and the end user also needs to know which contact the token belongs to, this data can be returned in the accountvaults endpoint request. Constraints: Unique Items Required, Pattern: ^[\w]+$ |
$contactId = '11e95f8ec39de8fbdb0a4f1a';
$body = V1ContactsRequest1Builder::init()
->locationId('11e95f8ec39de8fbdb0a4f1a')
->accountNumber('54545433332')
->contactApiId('137')
->firstName('John')
->lastName('Smith')
->cellPhone('3339998822')
->balance(245.36)
->companyName('Fortis Payment Systems, LLC')
->headerMessage('This is a sample message for you')
->dateOfBirth('2021-12-01')
->emailTrxReceipt(true)
->homePhone('3339998822')
->officePhone('3339998822')
->officePhoneExt('5')
->headerMessageType(0)
->updateIfExists(UpdateIfExistsEnum::ENUM_1)
->contactC1('any')
->contactC2('anything')
->contactC3('something')
->parentId('11e95f8ec39de8fbdb0a4f1a')
->email('[email protected]')
->build();
$result = $contactsController->updateContact(
$contactId,
$body
);{
"type": "Contact",
"data": {
"location_id": "11e95f8ec39de8fbdb0a4f1a",
"account_number": "54545433332",
"contact_api_id": "137",
"first_name": "John",
"last_name": "Smith",
"cell_phone": "3339998822",
"balance": 245.36,
"address": {
"city": "Novi",
"state": "Michigan",
"postal_code": "48375",
"country": "US"
},
"company_name": "Fortis Payment Systems, LLC",
"header_message": "This is a sample message for you",
"date_of_birth": "2021-12-01",
"email_trx_receipt": true,
"home_phone": "3339998822",
"office_phone": "3339998822",
"office_phone_ext": "5",
"header_message_type": 0,
"update_if_exists": 1,
"contact_c1": "any",
"contact_c2": "anything",
"contact_c3": "something",
"parent_id": "11e95f8ec39de8fbdb0a4f1a",
"email": "[email protected]",
"id": "11e95f8ec39de8fbdb0a4f1a",
"created_ts": 1422040992,
"modified_ts": 1422040992,
"active": true,
"received_emails": [
{
"subject": "Payment Receipt - 12skiestech",
"body": "This email is being sent from a server.",
"source_address": "\"12skiestech A7t3qi\" <[email protected]>",
"return_path": "\"12skiestech A7t3qi\" <[email protected]>",
"provider_id": "0100017e67bcc530-e1dd23b4-8a39-4a5b-8d5d-68d51c4c942f-000000",
"domain_id": "11e95f8ec39de8fbdb0a4f1a",
"reason_sent": "Contact Email",
"reason_model": "Transaction",
"reason_model_id": "11e95f8ec39de8fbdb0a4f1a",
"reply_to": "\"Zeamster\" <[email protected]>",
"id": "11e95f8ec39de8fbdb0a4f1a",
"created_ts": 1422040992
}
],
"is_deletable": true,
"location": {
"id": "11e95f8ec39de8fbdb0a4f1a",
"created_ts": 1422040992,
"modified_ts": 1422040992,
"account_number": "5454545454545454",
"address": {
"city": "Novi",
"state": "MI",
"postal_code": "48375",
"country": "US"
},
"branding_domain_id": "11e95f8ec39de8fbdb0a4f1a",
"contact_email_trx_receipt_default": true,
"default_ach": "11e608a7d515f1e093242bb2",
"default_cc": "11e608a442a5f1e092242dda",
"email_reply_to": "[email protected]",
"fax": "3339998822",
"location_api_id": "location-111111",
"location_api_key": "AE34BBCAADF4AE34BBCAADF4",
"location_c1": "custom 1",
"location_c2": "custom 2",
"location_c3": "custom data 3",
"name": "Sample Company Headquarters",
"office_phone": "2481234567",
"office_ext_phone": "1021021209",
"tz": "America/New_York",
"parent_id": "11e95f8ec39de8fbdb0a4f1a",
"show_contact_notes": true,
"show_contact_files": true,
"ticket_hash_key": "A5F443CADF4AE34BBCAADF4"
},
"user": {
"account_number": "5454545454545454",
"branding_domain_url": "{branding_domain_url}",
"cell_phone": "3339998822",
"company_name": "Fortis Payment Systems, LLC",
"contact_id": "11e95f8ec39de8fbdb0a4f1a",
"date_of_birth": "2021-12-01",
"domain_id": "11e95f8ec39de8fbdb0a4f1a",
"email": "[email protected]",
"email_trx_receipt": true,
"home_phone": "3339998822",
"first_name": "John",
"last_name": "Smith",
"locale": "en-US",
"office_phone": "3339998822",
"office_ext_phone": "5",
"primary_location_id": "11e95f8ec39de8fbdb0a4f1a",
"requires_new_password": null,
"terms_condition_code": "20220308",
"tz": "America/New_York",
"ui_prefs": {
"entry_page": "dashboard",
"page_size": 2,
"report_export_type": "csv",
"process_method": "virtual_terminal",
"default_terminal": "11e95f8ec39de8fbdb0a4f1a"
},
"username": "{user_name}",
"user_api_key": "234bas8dfn8238f923w2",
"user_hash_key": null,
"user_type_code": 100,
"password": null,
"zip": "48375",
"location_id": "11e95f8ec39de8fbdb0a4f1a",
"status_id": 1,
"api_only": false,
"is_invitation": false,
"address": {
"city": "Novi",
"state": "MI",
"postal_code": "48375",
"country": "US"
},
"id": "11e95f8ec39de8fbdb0a4f1a",
"status": true,
"login_attempts": 0,
"last_login_ts": 1422040992,
"created_ts": 1422040992,
"modified_ts": 1422040992,
"created_user_id": "11e95f8ec39de8fbdb0a4f1a",
"terms_accepted_ts": 1422040992,
"terms_agree_ip": "192.168.0.10",
"current_date_time": "2019-03-11T10:38:26-0700"
},
"recurrings": [
{
"account_vault_id": "11e95f8ec39de8fbdb0a4f1a",
"token_id": "11e95f8ec39de8fbdb0a4f1a",
"account_vault_api_id": "token1234abcd",
"token_api_id": "token1234abcd",
"_joi": {
"conditions": {}
},
"active": true,
"description": "Description",
"end_date": "2021-12-01",
"installment_total_count": 20,
"interval": 1,
"interval_type": "d",
"location_id": "11e95f8ec39de8fbdb0a4f1a",
"notification_days": 2,
"payment_method": "cc",
"product_transaction_id": "11e95f8ec39de8fbdb0a4f1a",
"recurring_id": "11e95f8ec39de8fbdb0a4f1a",
"recurring_api_id": "recurring1234abcd",
"start_date": "2021-12-01",
"status": "active",
"transaction_amount": 300,
"terms_agree": true,
"terms_agree_ip": "192.168.0.10",
"recurring_c1": "recurring custom data 1",
"recurring_c2": "recurring custom data 2",
"recurring_c3": "recurring custom data 3",
"send_to_proc_as_recur": true,
"id": "11e95f8ec39de8fbdb0a4f1a",
"next_run_date": "2021-12-01",
"created_ts": 1422040992,
"modified_ts": 1422040992,
"recurring_type_id": "i",
"installment_amount_total": 99999999
}
],
"email_blacklist": {
"id": "11e95f8ec39de8fbdb0a4f1a",
"isBlacklisted": true,
"detail": true,
"created_ts": 1422040992
},
"sms_blacklist": {
"id": "11e95f8ec39de8fbdb0a4f1a",
"isBlacklisted": true,
"detail": true,
"created_ts": 1422040992
},
"changelogs": [
{
"id": "11e95f8ec39de8fbdb0a4f1a",
"created_ts": 1422040992,
"action": "CREATE",
"model": "TransactionRequest",
"model_id": "11ec829598f0d4008be9aba4",
"user_id": "11e95f8ec39de8fbdb0a4f1a",
"changelog_details": [
{
"id": "11e95f8ec39de8fbdb0a4f1a",
"changelog_id": "11e95f8ec39de8fbdb0a4f1a",
"field": "next_run_ts",
"old_value": "1643616000"
}
],
"user": {
"id": "11e95f8ec39de8fbdb0a4f1a",
"username": "[email protected]",
"first_name": "Bob",
"last_name": "Fairview"
}
}
],
"postback_logs": [
{
"id": "11e95f8ec39de8fbdb0a4f1a",
"postback_config_id": "11e95f8ec39de8fbdb0a4f1a",
"changelog_id": "11e95f8ec39de8fbdb0a4f1a",
"next_run_ts": 1422040992,
"created_ts": 1422040992,
"model_id": "11e95f8ec39de8fbdb0a4f1a"
}
],
"created_user": {
"account_number": "5454545454545454",
"branding_domain_url": "{branding_domain_url}",
"cell_phone": "3339998822",
"company_name": "Fortis Payment Systems, LLC",
"contact_id": "11e95f8ec39de8fbdb0a4f1a",
"date_of_birth": "2021-12-01",
"domain_id": "11e95f8ec39de8fbdb0a4f1a",
"email": "[email protected]",
"email_trx_receipt": true,
"home_phone": "3339998822",
"first_name": "John",
"last_name": "Smith",
"locale": "en-US",
"office_phone": "3339998822",
"office_ext_phone": "5",
"primary_location_id": "11e95f8ec39de8fbdb0a4f1a",
"requires_new_password": null,
"terms_condition_code": "20220308",
"tz": "America/New_York",
"ui_prefs": {
"entry_page": "dashboard",
"page_size": 2,
"report_export_type": "csv",
"process_method": "virtual_terminal",
"default_terminal": "11e95f8ec39de8fbdb0a4f1a"
},
"username": "{user_name}",
"user_api_key": "234bas8dfn8238f923w2",
"user_hash_key": null,
"user_type_code": 100,
"password": null,
"zip": "48375",
"location_id": "11e95f8ec39de8fbdb0a4f1a",
"status_id": 1,
"api_only": false,
"is_invitation": false,
"address": {
"city": "Novi",
"state": "MI",
"postal_code": "48375",
"country": "US"
},
"id": "11e95f8ec39de8fbdb0a4f1a",
"status": true,
"login_attempts": 0,
"last_login_ts": 1422040992,
"created_ts": 1422040992,
"modified_ts": 1422040992,
"created_user_id": "11e95f8ec39de8fbdb0a4f1a",
"terms_accepted_ts": 1422040992,
"terms_agree_ip": "192.168.0.10",
"current_date_time": "2019-03-11T10:38:26-0700"
},
"parent": {
"location_id": "11e95f8ec39de8fbdb0a4f1a",
"account_number": "54545433332",
"contact_api_id": "137",
"first_name": "John",
"last_name": "Smith",
"cell_phone": "3339998822",
"balance": 245.36,
"address": {
"city": "Novi",
"state": "Michigan",
"postal_code": "48375",
"country": "US"
},
"company_name": "Fortis Payment Systems, LLC",
"header_message": "This is a sample message for you",
"date_of_birth": "2021-12-01",
"email_trx_receipt": true,
"home_phone": "3339998822",
"office_phone": "3339998822",
"office_phone_ext": "5",
"header_message_type": 0,
"update_if_exists": 1,
"contact_c1": "any",
"contact_c2": "anything",
"contact_c3": "something",
"parent_id": "11e95f8ec39de8fbdb0a4f1a",
"email": "[email protected]",
"id": "11e95f8ec39de8fbdb0a4f1a",
"created_ts": 1422040992,
"modified_ts": 1422040992,
"active": true
},
"children": {
"location_id": "11e95f8ec39de8fbdb0a4f1a",
"account_number": "54545433332",
"contact_api_id": "137",
"first_name": "John",
"last_name": "Smith",
"cell_phone": "3339998822",
"balance": 245.36,
"address": {
"city": "Novi",
"state": "Michigan",
"postal_code": "48375",
"country": "US"
},
"company_name": "Fortis Payment Systems, LLC",
"header_message": "This is a sample message for you",
"date_of_birth": "2021-12-01",
"email_trx_receipt": true,
"home_phone": "3339998822",
"office_phone": "3339998822",
"office_phone_ext": "5",
"header_message_type": 0,
"update_if_exists": 1,
"contact_c1": "any",
"contact_c2": "anything",
"contact_c3": "something",
"parent_id": "11e95f8ec39de8fbdb0a4f1a",
"email": "[email protected]",
"id": "11e95f8ec39de8fbdb0a4f1a",
"created_ts": 1422040992,
"modified_ts": 1422040992,
"active": true
}
}
}| HTTP Status Code | Error Description | Exception Class |
|---|---|---|
| 401 | Unauthorized | Response401tokenException |
| 412 | Precondition Failed | Response412Exception |