BokaMera.API.Host

<back to all web services

QvicklyCheckoutv1CreateCheckout

The following routes are available for this service:
POST/payment/billmate/v1/checkoutCreate an checkout for Booking. Note if existing checkouts already exists, i will invalidate those.Create Qvickly checkout (requires settings for Billmat Checkout 1.0)
<?php namespace dtos;

use DateTime;
use Exception;
use DateInterval;
use JsonSerializable;
use ServiceStack\{IReturn,IReturnVoid,IGet,IPost,IPut,IDelete,IPatch,IMeta,IHasSessionId,IHasBearerToken,IHasVersion};
use ServiceStack\{ICrud,ICreateDb,IUpdateDb,IPatchDb,IDeleteDb,ISaveDb,AuditBase,QueryDb,QueryDb2,QueryData,QueryData2,QueryResponse};
use ServiceStack\{ResponseStatus,ResponseError,EmptyResponse,IdResponse,ArrayList,KeyValuePair2,StringResponse,StringsResponse,Tuple2,Tuple3,ByteArray};
use ServiceStack\{JsonConverters,Returns,TypeContext};


class QvicklyCheckoutQueryResponse implements JsonSerializable
{
    public function __construct(
        /** @description The checkout id */
        // @ApiMember(Description="The checkout id")
        /** @var int */
        public int $Number=0,

        /** @description The url for checkout module to be placed in a iframe */
        // @ApiMember(Description="The url for checkout module to be placed in a iframe")
        /** @var string|null */
        public ?string $Url=null,

        /** @description The checkout status */
        // @ApiMember(Description="The checkout status")
        /** @var string|null */
        public ?string $Status=null
    ) {
    }

    /** @throws Exception */
    public function fromMap($o): void {
        if (isset($o['Number'])) $this->Number = $o['Number'];
        if (isset($o['Url'])) $this->Url = $o['Url'];
        if (isset($o['Status'])) $this->Status = $o['Status'];
    }
    
    /** @throws Exception */
    public function jsonSerialize(): mixed
    {
        $o = [];
        if (isset($this->Number)) $o['Number'] = $this->Number;
        if (isset($this->Url)) $o['Url'] = $this->Url;
        if (isset($this->Status)) $o['Status'] = $this->Status;
        return empty($o) ? new class(){} : $o;
    }
}

enum PaymentOrigin : string
{
    case HomePage = 'HomePage';
    case Embedded = 'Embedded';
    case Admin = 'Admin';
    case Apps = 'Apps';
    case HomePageNew = 'HomePageNew';
}

class QvicklyCheckoutv1CreateCheckout implements ICompany, JsonSerializable
{
    public function __construct(
        /** @description The company id. */
        // @ApiMember(Description="The company id.", IsRequired=true)
        /** @var string */
        public string $CompanyId='',

        /** @description The booking id. */
        // @ApiMember(Description="The booking id.", IsRequired=true)
        /** @var int */
        public int $BookingId=0,

        /** @description Optional to set the checkout url. This url will be redirected to if payment is interupted for some reason. */
        // @ApiMember(Description="Optional to set the checkout url. This url will be redirected to if payment is interupted for some reason.")
        /** @var string|null */
        public ?string $CheckoutUrl=null,

        /** @description Optional to set your own confirmation url after payment completed. */
        // @ApiMember(Description="Optional to set your own confirmation url after payment completed.")
        /** @var string|null */
        public ?string $ConfirmationUrl=null,

        /** @description The payment origin id. HomePage = 0, Embedded = 1, Admin = 2, Apps = 3 */
        // @ApiMember(Description="The payment origin id. HomePage = 0, Embedded = 1, Admin = 2, Apps = 3", IsRequired=true)
        /** @var PaymentOrigin|null */
        public ?PaymentOrigin $PaymentOrigin=null,

        /** @description If you want to have another language (sv, fi, dk, no, en) than the default language in system settings, specify it here. Leave empty if default language should be used. */
        // @ApiMember(Description="If you want to have another language (sv, fi, dk, no, en) than the default language in system settings, specify it here. Leave empty if default language should be used.", IsRequired=true)
        /** @var string */
        public string $Language='',

        /** @description Determins if it's a test call */
        // @ApiMember(Description="Determins if it's a test call")
        /** @var bool|null */
        public ?bool $TestMode=null
    ) {
    }

    /** @throws Exception */
    public function fromMap($o): void {
        if (isset($o['CompanyId'])) $this->CompanyId = $o['CompanyId'];
        if (isset($o['BookingId'])) $this->BookingId = $o['BookingId'];
        if (isset($o['CheckoutUrl'])) $this->CheckoutUrl = JsonConverters::from('string', $o['CheckoutUrl']);
        if (isset($o['ConfirmationUrl'])) $this->ConfirmationUrl = JsonConverters::from('string', $o['ConfirmationUrl']);
        if (isset($o['PaymentOrigin'])) $this->PaymentOrigin = JsonConverters::from('PaymentOrigin', $o['PaymentOrigin']);
        if (isset($o['Language'])) $this->Language = $o['Language'];
        if (isset($o['TestMode'])) $this->TestMode = $o['TestMode'];
    }
    
    /** @throws Exception */
    public function jsonSerialize(): mixed
    {
        $o = [];
        if (isset($this->CompanyId)) $o['CompanyId'] = $this->CompanyId;
        if (isset($this->BookingId)) $o['BookingId'] = $this->BookingId;
        if (isset($this->CheckoutUrl)) $o['CheckoutUrl'] = JsonConverters::to('string', $this->CheckoutUrl);
        if (isset($this->ConfirmationUrl)) $o['ConfirmationUrl'] = JsonConverters::to('string', $this->ConfirmationUrl);
        if (isset($this->PaymentOrigin)) $o['PaymentOrigin'] = JsonConverters::to('PaymentOrigin', $this->PaymentOrigin);
        if (isset($this->Language)) $o['Language'] = $this->Language;
        if (isset($this->TestMode)) $o['TestMode'] = $this->TestMode;
        return empty($o) ? new class(){} : $o;
    }
}

PHP QvicklyCheckoutv1CreateCheckout DTOs

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

HTTP + JSV

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

POST /payment/billmate/v1/checkout HTTP/1.1 
Host: testapi.bokamera.se 
Accept: text/jsv
Content-Type: text/jsv
Content-Length: length

{
	CompanyId: 00000000-0000-0000-0000-000000000000,
	BookingId: 0,
	PaymentOrigin: HomePage,
	Language: String,
	TestMode: False
}
HTTP/1.1 200 OK
Content-Type: text/jsv
Content-Length: length

{
	Number: 0,
	Url: String,
	Status: String
}