Getting and Updating People
A Person can be retrieved or updated via this method.
Method Info
Url | https://www.payit2.com/api/v1/collect-page/{CollectPageId}/Person/{Id} |
---|---|
Verb | GET, PUT/POST |
Headers | X-PayItSquare-AppKey, X-PayItSquare-Token |
{CollectPageId} | The id of the collect page to get payers for. |
{Id} | The id of the Person. |
Input
Property | Data Type | Validation Info |
---|---|---|
FirstName | String | The Person's first name. This is used for display on the collect page and in messages sent for reminders. Required |
LastName | String | The Person's last name. This is used for display on the collect page and in messages sent for reminders. Required |
EmailAddress | String | This is the email address that reminder emails will be sent to. Required |
IsAmountNeededOverriden | Boolean | If the amount needed from this Person is different than the default amount for the collect page, this will be true. |
OverriddenAmountNeeded | Single | If IsAmountNeededOverriden is true, this will contain the amount needed. |
AmountCollected | Single | If a Person has paid, this will contain the amount the Person paid. |
IsManualPayment | Boolean | When true, this indicates that they Person marked themselves as paid. |
Output
Property | Data Type | Other Info |
---|---|---|
Id | Guid | This is the id of the Person. This will be needed for updating the Person. |
PaidDateTime | DateTime Array | If the Person has paid, this is the date they paid. If this is null, the Person has not paid yet. |
LastViewedDate | DateTime Array | |
IsOnlinePayment | Boolean | If true, the Person paid online through PayPal. |
IsSelfPayment | Boolean | If true, the Person marked themselves as paid on the collect page. |
PaymentStatus | String | |
IsPendingPayNow | Boolean | |
IsPrivate | Boolean | If true, the user has marked their payment as private. |
CanDelete | Boolean | Determines if this Person can be deleted. Online payments cannot be deleted. |
AmountDueOffline | Single | |
IsRegistered | Boolean | |
FirstName | String | The Person's first name. This is used for display on the collect page and in messages sent for reminders. |
LastName | String | The Person's last name. This is used for display on the collect page and in messages sent for reminders. |
EmailAddress | String | This is the email address that reminder emails will be sent to. |
IsAmountNeededOverriden | Boolean | If the amount needed from this Person is different than the default amount for the collect page, this will be true. |
OverriddenAmountNeeded | Single | If IsAmountNeededOverriden is true, this will contain the amount needed. |
AmountCollected | Single | If a Person has paid, this will contain the amount the Person paid. |
IsManualPayment | Boolean | When true, this indicates that they Person marked themselves as paid. |
Sample Get Output
{ "Id": "4d99bf76-97b9-4e4f-b992-8518b3812eb2", "PaidDateTime": null, "LastViewedDate": null, "IsOnlinePayment": false, "IsSelfPayment": false, "PaymentStatus": null, "IsPendingPayNow": false, "IsPrivate": false, "CanDelete": false, "AmountDueOffline": 0.0, "IsRegistered": false, "FirstName": "Jane", "LastName": "Doe", "EmailAddress": "me@mydomain.com", "IsAmountNeededOverriden": false, "OverriddenAmountNeeded": 0.0, "AmountCollected": 0.0, "IsManualPayment": false }
Sample Input
{ "FirstName": "Jane", "LastName": "Doe", "EmailAddress": "myaddress@mydomain.com", "IsAmountNeededOverriden": false, "OverriddenAmountNeeded": 0.0, "AmountCollected": 0.0, "IsManualPayment": false }
Sample Success Response
{ "IsSuccess": true, "Messages": [] }
Sample Error Response
{ "IsSuccess": false, "Messages": [ "Error Message 1", "Error Message 2" ] }