Instant payment

The instant_payment graph reserves the booked time-slot when created and automatically frees the time-slot if a payment isn't registered within 5 minutes.

For a complete tutorial on how to implement payments, please read this tutorial in out help center: http://help.timekit.io/working-with-the-api/recipes/integrating-payments

When you register the payment, by applying the pay action to the booking, you can supply a payment_id to the request, like so:

curl --request PUT \
     --url https://api.timekit.io/v2/bookings/9d3fc349-5605-4bbf-a8fd-270fee55c137/pay \
     --header 'Content-Type: application/json' \
     --user :live_api_key_7nzvc7wsBQQISLeFSVhROys9V1bUJ1z7
     --data '{
          "pay": {
            "payment_id": ":payment_id_string"
          }
        }'

Available actions:

  • create ➡️ state=tentative

When in tentative state

  • timeout ➡️ state=unpaid
  • pay ➡️ state=paid

When in paid state

  • cancel ➡️ state=cancelled
  • complete ➡️ state=completed

Available webhook states

  • tentative
  • paid
  • cancelled
  • unpaid
  • completed
  • error