Selecting a Tee Time in the Sandbox

You can search for tee times using one of our many tee time searches. In order to book a tee time in our Sandbox, however, you must search for and select tee times with very specific parameters:

The one's digit of the minute component of the tee time can also determine your ability to book. Review the following table for details:


Outcome Minutes Component (ends with) Description
Available 0,1,4,5,6,7,8,9 The tee time is available on the tee sheet and can be booked.
Not Available 2 The tee time is NOT available on the tee sheet.
Not Bookable 3 The tee time is available, however it cannot be booked for some reason.

This means that a tee time at 7:41 AM would be AVAILBLE. A tee time at 9:32 AM would NOT be AVAILABLE. Finally, a tee time at 8:13 AM would be available but NOT BOOKABLE.


There are times when the interface between GolfNow and a golf course may fail. In order to simulate these scenarios, a tee time rate with a price that has a cent value between 91 and 99 inclusive will also fail regardless of the minute component of the tee time. The following table provides details on the error messages that can be returned.


Price Component (ends with) Description
.91 Reservation not allowed
.92 Time not available
.93 Invalid response
.94 Invalid request
.95 Invalid customer information
.96 Invalid credential
.97 Invalid course information
.98 Communication timeout
.99 Communication error

Specifying a Payment Method

Credit Card

The following sample demonstrates how to use a credit card to reserve a tee time.

HTTP Request

POST /rest/customers/[email protected]/reservations HTTP/1.1
Content-Type: application/json; charset=utf-8
UserName: UserName
Password: Password
CustomerToken: 3fbjh0KafQ4S5id-4aHrNvtCYlPD3bzLWJ2rWq9HiBvvyCCvQV8czUHfuxtrmtalUFKLy+H+HT8lN1Hh7e8LY4IViuGZdiOmlwZ8y5R-uFcmHX2AfUOiPVihQk28vVGFOXDAvlJQ2V++wOhQ22koAjt-mOdZWkX-AC6d4KGwlJ10OhO7nc699NA+SxrG7OHE460wNCNivZvKtSBbbpphfR0pGf3mIx+nXoyrF6sLhVIpJcHMjCqo1-EEvTZzGO6i5gz3JEsBdITjXLz5a4KyCkLNfmOyaRahqzatH43p3jH7eCJtPxNyPWc7V7JxqBCxBNDsniX5u7J+-Dg8ZSOiQ1Zem4LH9TT6H2u7KFdiYuVHGlGNsrrV+mJWocuSvwUvstU3MXL1-GoXlOCuMHCYFb33x34q6VUE27tz9qh1AUc-Oisln8jvb97EPUoKwiiF9h7LVRPr9Lp8eYDRFuJK3pqcHObJo6CNNyIpKxykZ4JqPod3FCL2Bbs6NWze58Wy4niAqYSxaSFupxYcomzXIP0m9+A3b8Nm0OySmJTUknwc9Ad4Z+jN4jyFXNSLSj+36Skura15YspwQGIFk9GvRC-2oEoovfsM4RK5SKFYMei7fpx+X34VCNPzFFtxIbPWKk52e-J2uHhMzGK4iyJBeNa8XMHhc06kAGX6VWqnEK5f33Ev4YNrUCMFZBVz1wTR
Host: sandbox.api.gnsvc.com
Accept-Encoding: gzip, deflate
AdvancedErrorCodes: True

Body

Saved Credit Card

The following code sample is a basic tee time reservation request using a customer's presaved credit card. In order to reserve a tee time, you must have authenticated the customer and pass in the customer token in the header alone with the request.

HTTP Request

POST /rest/customers/[email protected]/reservations HTTP/1.1
Content-Type: application/json; charset=utf-8
UserName: UserName
Password: Password
CustomerToken: 3fbjh0KafQ4S5id-4aHrNvtCYlPD3bzLWJ2rWq9HiBvvyCCvQV8czUHfuxtrmtalUFKLy+H+HT8lN1Hh7e8LY4IViuGZdiOmlwZ8y5R-uFcmHX2AfUOiPVihQk28vVGFOXDAvlJQ2V++wOhQ22koAjt-mOdZWkX-AC6d4KGwlJ10OhO7nc699NA+SxrG7OHE460wNCNivZvKtSBbbpphfR0pGf3mIx+nXoyrF6sLhVIpJcHMjCqo1-EEvTZzGO6i5gz3JEsBdITjXLz5a4KyCkLNfmOyaRahqzatH43p3jH7eCJtPxNyPWc7V7JxqBCxBNDsniX5u7J+-Dg8ZSOiQ1Zem4LH9TT6H2u7KFdiYuVHGlGNsrrV+mJWocuSvwUvstU3MXL1-GoXlOCuMHCYFb33x34q6VUE27tz9qh1AUc-Oisln8jvb97EPUoKwiiF9h7LVRPr9Lp8eYDRFuJK3pqcHObJo6CNNyIpKxykZ4JqPod3FCL2Bbs6NWze58Wy4niAqYSxaSFupxYcomzXIP0m9+A3b8Nm0OySmJTUknwc9Ad4Z+jN4jyFXNSLSj+36Skura15YspwQGIFk9GvRC-2oEoovfsM4RK5SKFYMei7fpx+X34VCNPzFFtxIbPWKk52e-J2uHhMzGK4iyJBeNa8XMHhc06kAGX6VWqnEK5f33Ev4YNrUCMFZBVz1wTR
Host: sandbox.api.gnsvc.com
Accept-Encoding: gzip, deflate
AdvancedErrorCodes: True

Body

Affiliate Payment

The following sample demonstrates how to reserve a tee time using an affiliate payment. Please note the following:

HTTP Request

POST /rest/customers/[email protected]/reservations HTTP/1.1
Content-Type: application/json; charset=utf-8
UserName: UserName
Password: Password
CustomerToken: 3fbjh0KafQ4S5id-4aHrNvtCYlPD3bzLWJ2rWq9HiBvvyCCvQV8czUHfuxtrmtalUFKLy+H+HT8lN1Hh7e8LY4IViuGZdiOmlwZ8y5R-uFcmHX2AfUOiPVihQk28vVGFOXDAvlJQ2V++wOhQ22koAjt-mOdZWkX-AC6d4KGwlJ10OhO7nc699NA+SxrG7OHE460wNCNivZvKtSBbbpphfR0pGf3mIx+nXoyrF6sLhVIpJcHMjCqo1-EEvTZzGO6i5gz3JEsBdITjXLz5a4KyCkLNfmOyaRahqzatH43p3jH7eCJtPxNyPWc7V7JxqBCxBNDsniX5u7J+-Dg8ZSOiQ1Zem4LH9TT6H2u7KFdiYuVHGlGNsrrV+mJWocuSvwUvstU3MXL1-GoXlOCuMHCYFb33x34q6VUE27tz9qh1AUc-Oisln8jvb97EPUoKwiiF9h7LVRPr9Lp8eYDRFuJK3pqcHObJo6CNNyIpKxykZ4JqPod3FCL2Bbs6NWze58Wy4niAqYSxaSFupxYcomzXIP0m9+A3b8Nm0OySmJTUknwc9Ad4Z+jN4jyFXNSLSj+36Skura15YspwQGIFk9GvRC-2oEoovfsM4RK5SKFYMei7fpx+X34VCNPzFFtxIbPWKk52e-J2uHhMzGK4iyJBeNa8XMHhc06kAGX6VWqnEK5f33Ev4YNrUCMFZBVz1wTR
Host: sandbox.api.gnsvc.com
Accept-Encoding: gzip, deflate
AdvancedErrorCodes: True

Body

Gift Card Payment

The following demonstrates the use of a gift card payment. You must have previously added a gift card to the customer's account (using SavePaymentOption()) before taking advantage of this payment type.

HTTP Request

POST /rest/customers/[email protected]/reservations HTTP/1.1
Content-Type: application/json; charset=utf-8
UserName: UserName
Password: Password
CustomerToken: 3fbjh0KafQ4S5id-4aHrNvtCYlPD3bzLWJ2rWq9HiBvvyCCvQV8czUHfuxtrmtalUFKLy+H+HT8lN1Hh7e8LY4IViuGZdiOmlwZ8y5R-uFcmHX2AfUOiPVihQk28vVGFOXDAvlJQ2V++wOhQ22koAjt-mOdZWkX-AC6d4KGwlJ10OhO7nc699NA+SxrG7OHE460wNCNivZvKtSBbbpphfR0pGf3mIx+nXoyrF6sLhVIpJcHMjCqo1-EEvTZzGO6i5gz3JEsBdITjXLz5a4KyCkLNfmOyaRahqzatH43p3jH7eCJtPxNyPWc7V7JxqBCxBNDsniX5u7J+-Dg8ZSOiQ1Zem4LH9TT6H2u7KFdiYuVHGlGNsrrV+mJWocuSvwUvstU3MXL1-GoXlOCuMHCYFb33x34q6VUE27tz9qh1AUc-Oisln8jvb97EPUoKwiiF9h7LVRPr9Lp8eYDRFuJK3pqcHObJo6CNNyIpKxykZ4JqPod3FCL2Bbs6NWze58Wy4niAqYSxaSFupxYcomzXIP0m9+A3b8Nm0OySmJTUknwc9Ad4Z+jN4jyFXNSLSj+36Skura15YspwQGIFk9GvRC-2oEoovfsM4RK5SKFYMei7fpx+X34VCNPzFFtxIbPWKk52e-J2uHhMzGK4iyJBeNa8XMHhc06kAGX6VWqnEK5f33Ev4YNrUCMFZBVz1wTR
Host: sandbox.api.gnsvc.com
Accept-Encoding: gzip, deflate
AdvancedErrorCodes: True

Body

Note that if the customer is a guest, gift cards may be applied as payment options as a part of the PaymentInformation array during the call to AddReservation, as follows.

HTTP Request

POST /rest/customers/[email protected]/reservations HTTP/1.1
Content-Type: application/json; charset=utf-8
UserName: UserName
Password: Password
CustomerToken: 3fbjh0KafQ4S5id-4aHrNvtCYlPD3bzLWJ2rWq9HiBvvyCCvQV8czUHfuxtrmtalUFKLy+H+HT8lN1Hh7e8LY4IViuGZdiOmlwZ8y5R-uFcmHX2AfUOiPVihQk28vVGFOXDAvlJQ2V++wOhQ22koAjt-mOdZWkX-AC6d4KGwlJ10OhO7nc699NA+SxrG7OHE460wNCNivZvKtSBbbpphfR0pGf3mIx+nXoyrF6sLhVIpJcHMjCqo1-EEvTZzGO6i5gz3JEsBdITjXLz5a4KyCkLNfmOyaRahqzatH43p3jH7eCJtPxNyPWc7V7JxqBCxBNDsniX5u7J+-Dg8ZSOiQ1Zem4LH9TT6H2u7KFdiYuVHGlGNsrrV+mJWocuSvwUvstU3MXL1-GoXlOCuMHCYFb33x34q6VUE27tz9qh1AUc-Oisln8jvb97EPUoKwiiF9h7LVRPr9Lp8eYDRFuJK3pqcHObJo6CNNyIpKxykZ4JqPod3FCL2Bbs6NWze58Wy4niAqYSxaSFupxYcomzXIP0m9+A3b8Nm0OySmJTUknwc9Ad4Z+jN4jyFXNSLSj+36Skura15YspwQGIFk9GvRC-2oEoovfsM4RK5SKFYMei7fpx+X34VCNPzFFtxIbPWKk52e-J2uHhMzGK4iyJBeNa8XMHhc06kAGX6VWqnEK5f33Ev4YNrUCMFZBVz1wTR
Host: sandbox.api.gnsvc.com
Accept-Encoding: gzip, deflate
AdvancedErrorCodes: True

Body

Test Credit Cards

A list of available test credit cards can be found on our FAQ page here.