Automated vs. Manual payments agent bookings

Updated August 21, 2018 23:54

A booking request is slightly different when using manual or automated payment.

Automated payment must be used when booking a product without any negotiated rate, or when a supplier has explicitly chosen to use automated payments with a negotiated rate.

For more details see:

https://support.rezdy.com/hc/en-us/sections/200696824-Marketplace

In any case the "agentPaymentType" field in the product entity would be set to "PAYOUTS".

Manual payment booking request

For manual payments (payment taken by the agent, not processed through Rezdy), you must send a "payments" field with details of the payment, for the booking to be marked as fully paid:

"payments": [
    {
      "type": "CREDITCARD",
      "amount": "200",
      "currency": "USD",
      "date": "2017-10-01T10:26:00Z",
      "label": "Payment processed by RezdyDemoAgent"
    }
  ]

Automated payments booking request

Automated payments must be processed by Stripe on the Rezdy's account, thus we need a credit card token issued by Stripe to process the customer payment, e.g.:

"creditCard":
   {
    "cardToken": "tok_123xyzcyKLM1234abcXYABC"
   }
}

Note: You must generate the token using a PCI-compliant solution provided by Stripe, like Stripe.js or Stripe Elements. You cannot generate the token with server-to-server Stripe API.

Any payment passed in the "payments" field in this case, are considered as payments processed by the agent. E.g. agent discounts given to a customer, and only reduce the agent's commission. This can result in an error "The selling price is too low to cover agent commission.", if the amount after discount/external payment is lower than the supplier's net price + automatic payment booking fee.

For details about the agent discount see:

https://support.rezdy.com/hc/en-us/articles/226514788-Booking-quote-commission-calculation-and-agent-discounts-explained

To see the full sample booking requests see:

https://support.rezdy.com/hc/en-us/articles/115003888027-Agent-Getting-started-with-the-API

Was this article helpful?

0 out of 0 found this helpful

Comments

2 comments

Paul Middleton December 04, 2017 12:50
I'm getting the error "The selling price is too low to cover agent commision.".

My "payments" field is:
```
"payments": [ {
        "type": "CREDITCARD",
        "amount": "100",
        "currency": "AUD",
        "date": "2017-12-04T23:50:00Z",
        "label": "Payment processed by agent"
      } ]
```
This is for a single ticket costing $100.

Can you please clarify:
1. Is it possible for the Agent to take the full payment manually from the customer, then reimburse the supplier?
2. What value should appear in payments: amount field if this is possible?
Thanks.
0

Comment actions Permalink
Dusan Zahoransky December 07, 2017 06:02

Hi Paul,

it is based on an agreement with a supplier what payment type will be used for the bookings of their products, please check the articles in the agents section for details https://support.rezdy.com/hc/en-us/categories/200238194-For-Agents

Via API, check the field product.agentPaymentType to see what option is available for a certain product.

Based on the error, it looks like you were trying to book an automated payment product with manual payments data in your request, moreover you have entered a custom price for the booking items and set it too low (see https://support.rezdy.com/hc/en-us/articles/226514788-Booking-quote-commission-calculation-and-agent-discounts-explained).

If you still have an issue with the booking service, please send me the request details to api-support@rezdy.com

Cheers,

Dusan

0

Comment actions Permalink

Please sign in to leave a comment.

Related articles