API - Planyo Web Services - add_reservation_payment

You are here: Planyo » Help » API » add_reservation_payment

add_reservation_payment (version 1)


Adds a payment for a reservation. You may NOT pass customer's credit card numbers in any of the fields. Planyo doesn't keep any credit card numbers on its servers.


reservation_id int required
Reservation ID for which the payment will be added.
payment_mode int required
The method used to make the payment: 2 - offline (cash), 3 - cheque, 4 - bank transfer, 5 - other, 6 - gift certificate, 9 - discount, 10 - credit card number left on file, or one of the payment gateways: 1 - Paypal, 7 - Paypal Sandbox, 8 - Moneybookers, 11 - WorldPay, 12 - WorldPay Test, 13 - Authorize.net, 14 - Sage Pay, 15 - Sage Pay Test, 16 - MultiSafepay, 17 - MultiSafepay Test, 18 - EBS, 19 - Servired, 20 - Servired Test, 21 - Authorize.net - DPM, 22 - Mastercard MiGS, 23 - Wirecard QPAY, 24 - Paybox, 25 - Mercanet, 26 - SystemPay, 27 - SystemPay Test, 99 - other payment gateway
payment_status int required
One of the values representing the status of the payment: 1 - payment successful, 2 - payment is pending, 3 - error, 4 - this is a refund
payment_response_code string optional
The response code returned by payment gateway. This can be a number or a text symbol like 'OK' etc.
transaction_id string required
Unique transaction ID of the payment.
transaction_status_text string optional
Optional status text e.g. reason for error
amount float required
The payment amount, e.g. 15.25 or 0.
currency string required
3-letter (ISO 4217) currency code e.g. EUR, USD, CHF, GBP etc.
version float optional
you can optionally specify the version of the API that you're using. Use the value of latest or simply skip this parameter to use the latest API version. The latest version is: 1
language string optional
by specifying a 2-letter (ISO 639-1) language code (all capital letters e.g. EN, DE, FR, ES, IT) you can change the language of the text values returned
api_key string required
your API key - Click here to get your key. If your API key uses a hash key, you must also include the parameters hash_key and hash_timestamp.


status int
Status of the reservation after the payment

API playground:

Click here to test this function in the API playground.