GET /payments
Verifies that the given paymentId exists in Club OS and you have access to it.
GET https://api.club-os.com/payments?clubLocationId=[clubLocationId]&paymentId=[paymentId]
Parameters
The following fields must be included as parameters in the URL of the request.
| Variable | Type | Description |
|---|---|---|
| clubLocationId | Integer | The Club OS unique id for the club location you wish to access. Club OS will provide these to you. |
| paymentId | Integer | The Club OS unique id for the payment you are requesting. |
POST /payments
Add a payment to the system.
POST https://api.club-os.com/payments?clubLocationId=[clubLocationId]
Parameters
The following fields must be included as parameters in the URL of the request.
| Variable | Type | Description |
|---|---|---|
| clubLocationId | Integer | The Club OS unique id for the club location you wish to access. Club OS will provide these to you. |
Request Body
The following fields must be included in the body of the HTTP request as a valid JSON string.
| Property | Type | Required | Default | Description |
|---|---|---|---|---|
| memberId | Integer | Y | The Club OS unique id for the member who made the payment. | |
| salespersonId | Integer | N | The Club OS unique id for the salesperson who was responsible for the payment. | |
| localPaymentId | String | Y | Your systems unique id for the payment. | |
| clubServiceId | Integer | N | The Club OS unique id for the club service that is being paid for. Use the /clubservices to get this id. Not required. | |
| name | String | N | The descriptive name of the product or service, i.e. 'Group Training', '30 Min Sessions', 'Multi-Vitamin'. Only required if no clubServiceId is used. | |
| qty | Decimal | Y | The qty purchased. | |
| unitPrice | Decimal | Y | The unit price (cost of 1 item) of the product or service. | |
| upc | String | N | The UPC for the product or service that was purchased. | |
| taxes | Decimal | N | The amount of taxes on the payment. | |
| saleDate | Date (M-d-YYYY) | Y | The date of the sale. | |
| expireDate | Date (M-d-YYYY) | N | The expiration date if one exists. |
Response Messages
One of the following messages will be returned when the request succeeds.
| Message | Description |
| Payment Created | Payment successfully created. |
| Payment Found | Payment exists in the system already. |
POST /payments/batch
Add multiple payments to the system.
POST https://api.club-os.com/payments/batch?clubLocationId=[clubLocationId]
This method works identical to the above method, but the request body needs to be an array of payments, rather than a single payment. Use this when there are multiple payments within a single order.
Note, if any payments in the batch fail, the entire batch will fail. Validation errors will be returned for the first invalid payment.