GET api/pos/payment/start/byPosId?orderId={orderId}&amount={amount}&posId={posId}&currencyCode={currencyCode}&accessToken={accessToken}&bioCode={bioCode}

Starts a payment by initiating a new payment based on a posId.
Upon calling this API, It will read the merchant information from Integra.
NOTE: A payment will only be initiated if there is no any active payment on the Pos

Request Information

URI Parameters

NameDescriptionTypeAdditional information
orderId

string

None.

amount

string

None.

posId

string

None.

currencyCode

string

None.

accessToken

string

None.

bioCode

string

None.

Body Parameters

None.

Response Information

Resource Description

paymentId if success is true, otherwise errors. You can use the paymentId to query payment status and capture the payment when its status is Reserved

PaymentStartViewModel
NameDescriptionTypeAdditional information
paymentId

string

None.

success

boolean

None.

errors

Collection of string

None.

Response Formats

application/xml, text/xml

Sample:
<PaymentStartViewModel xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/_1SA_MobilePay_POS_ViewModels.ViewModels">
  <errors xmlns:d2p1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
    <d2p1:string>sample string 1</d2p1:string>
    <d2p1:string>sample string 2</d2p1:string>
  </errors>
  <success>true</success>
  <paymentId>sample string 1</paymentId>
</PaymentStartViewModel>

application/json, text/json

Sample:
{
  "paymentId": "sample string 1",
  "success": true,
  "errors": [
    "sample string 1",
    "sample string 2"
  ]
}