BokaMera.API.Host

<back to all web services

PaymentSettingsQuery

Requires Authentication
Requires any of the roles:bookingsupplier-administrator-write, bookingsupplier-administrator-read, superadmin
The following routes are available for this service:
GET/payment/settingsGet payment settingsGet payment settings for the logged in company
PaymentSettingsQuery Parameters:
NameParameterData TypeRequiredDescription
CompanyIdqueryGuid?NoThe company id, if empty will use the company id for the user you are logged in with.
IncludeAdminPaymentOptionsquerybooleanNoIf you want to include the admin payment options to select from
IncludePaymentProviderOptionsquerybooleanNoIf you want to include the payment provider options to select from
PaymentSettingsQueryResponse Parameters:
NameParameterData TypeRequiredDescription
CompanyIdformGuidNoThe company id
EnabledformboolNoThe payment is enabled
RefundOnCancelBookingformboolNoAutomatically refund customer on canceled booking
DefaultPaymentOptionIdformint?NoThe default option when admin creates a new booking
PaymentProviderIdformintNoWhat payment provider to use
AdminPaymentOptionsquerybooleanYesIf you want to include the admin payment options to select from
PaymentProviderOptionsquerybooleanYesIf you want to include the payment provider options to select from
AdminPaymentOptionsResponse Parameters:
NameParameterData TypeRequiredDescription
IdformintNoThe payment options id
NameformstringYesThe payment options name
DescriptionformstringYesThe payment options description
PaymentProviderOptionsResponse Parameters:
NameParameterData TypeRequiredDescription
IdformintNoThe payment provider id
NameformstringYesThe payment provider name
DescriptionformstringYesThe payment provider description

To override the Content-type in your clients, use the HTTP Accept Header, append the .xml suffix or ?format=xml

HTTP + XML

The following are sample HTTP requests and responses. The placeholders shown need to be replaced with actual values.

GET /payment/settings HTTP/1.1 
Host: testapi.bokamera.se 
Accept: application/xml
HTTP/1.1 200 OK
Content-Type: application/xml
Content-Length: length

<PaymentSettingsQueryResponse xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/BokaMera.API.ServiceModel.Dtos">
  <AdminPaymentOptions>
    <AdminPaymentOptionsResponse>
      <Description>String</Description>
      <Id>0</Id>
      <Name>String</Name>
    </AdminPaymentOptionsResponse>
  </AdminPaymentOptions>
  <CompanyId>00000000-0000-0000-0000-000000000000</CompanyId>
  <DefaultPaymentOptionId>0</DefaultPaymentOptionId>
  <Enabled>false</Enabled>
  <PaymentProviderId>0</PaymentProviderId>
  <PaymentProviderOptions>
    <PaymentProviderOptionsResponse>
      <Description>String</Description>
      <Id>0</Id>
      <Name>String</Name>
    </PaymentProviderOptionsResponse>
  </PaymentProviderOptions>
  <RefundOnCancelBooking>false</RefundOnCancelBooking>
</PaymentSettingsQueryResponse>