POST Api/Vending/ValidatePayment

Request Information

URI Parameters

None.

Body Parameters

Name	Type	Additional information
VendingPurchaseID	globally unique identifier	None.
PaymentReference	string	None.
CustomerReferenceNumber	string	None.
CardContributionAmount	decimal number	None.
InstantEFTContributionAmount	decimal number	None.
WalletContributionAmount	decimal number	None.
Amount	decimal number	None.
AmountWithConvenience	decimal number	None.
PaymentTypeID	PaymentTypes	None.
Charges	Collection of Charges	None.
Username	string	None.
Password	string	None.
DeviceManufacturer	string	None.
DeviceModel	string	None.
DeviceSDKInt	string	None.
DeviceSDKVersion	string	None.

Request Formats

application/json, text/json

Sample:

{
  "VendingPurchaseID": "6cc674af-a51d-4b40-9360-38006869021d",
  "PaymentReference": "sample string 1",
  "CustomerReferenceNumber": "sample string 2",
  "CardContributionAmount": 3.0,
  "InstantEFTContributionAmount": 4.0,
  "WalletContributionAmount": 5.0,
  "Amount": 6.0,
  "AmountWithConvenience": 7.0,
  "PaymentTypeID": 1,
  "Charges": [
    {
      "LinkedAccountNo": "sample string 1",
      "Description": "sample string 2",
      "Balance": 3.0,
      "MinimumDue": 4.0,
      "DueDate": "2026-05-17T03:29:30.9055005+02:00",
      "NextTxMinAmountDue": 6.0,
      "AmountToPay": 7.0,
      "LinkedAccountUniqueID": "e7e789f0-3034-4213-a83a-48a16de78db6",
      "MaxMonthlyElectPurchaseAmount": 9.0,
      "RecordTypeName": "sample string 10",
      "PrimaryAccountNo": "sample string 11",
      "PaymentMethod": "sample string 12"
    },
    {
      "LinkedAccountNo": "sample string 1",
      "Description": "sample string 2",
      "Balance": 3.0,
      "MinimumDue": 4.0,
      "DueDate": "2026-05-17T03:29:30.9055005+02:00",
      "NextTxMinAmountDue": 6.0,
      "AmountToPay": 7.0,
      "LinkedAccountUniqueID": "e7e789f0-3034-4213-a83a-48a16de78db6",
      "MaxMonthlyElectPurchaseAmount": 9.0,
      "RecordTypeName": "sample string 10",
      "PrimaryAccountNo": "sample string 11",
      "PaymentMethod": "sample string 12"
    }
  ],
  "Username": "sample string 8",
  "Password": "sample string 9",
  "DeviceManufacturer": "sample string 10",
  "DeviceModel": "sample string 11",
  "DeviceSDKInt": "sample string 12",
  "DeviceSDKVersion": "sample string 13"
}

application/xml, text/xml

Sample:

<ValidatePaymentRequest xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/PPWAssistMobileAPI.Models">
  <DeviceManufacturer>sample string 10</DeviceManufacturer>
  <DeviceModel>sample string 11</DeviceModel>
  <DeviceSDKInt>sample string 12</DeviceSDKInt>
  <DeviceSDKVersion>sample string 13</DeviceSDKVersion>
  <Password>sample string 9</Password>
  <Username>sample string 8</Username>
  <Amount>6</Amount>
  <AmountWithConvenience>7</AmountWithConvenience>
  <CardContributionAmount>3</CardContributionAmount>
  <Charges>
    <Charges>
      <AmountToPay>7</AmountToPay>
      <Balance>3</Balance>
      <Description>sample string 2</Description>
      <DueDate>2026-05-17T03:29:30.9055005+02:00</DueDate>
      <LinkedAccountNo>sample string 1</LinkedAccountNo>
      <LinkedAccountUniqueID>e7e789f0-3034-4213-a83a-48a16de78db6</LinkedAccountUniqueID>
      <MaxMonthlyElectPurchaseAmount>9</MaxMonthlyElectPurchaseAmount>
      <MinimumDue>4</MinimumDue>
      <NextTxMinAmountDue>6</NextTxMinAmountDue>
      <PaymentMethod>sample string 12</PaymentMethod>
      <PrimaryAccountNo>sample string 11</PrimaryAccountNo>
      <RecordTypeName>sample string 10</RecordTypeName>
    </Charges>
    <Charges>
      <AmountToPay>7</AmountToPay>
      <Balance>3</Balance>
      <Description>sample string 2</Description>
      <DueDate>2026-05-17T03:29:30.9055005+02:00</DueDate>
      <LinkedAccountNo>sample string 1</LinkedAccountNo>
      <LinkedAccountUniqueID>e7e789f0-3034-4213-a83a-48a16de78db6</LinkedAccountUniqueID>
      <MaxMonthlyElectPurchaseAmount>9</MaxMonthlyElectPurchaseAmount>
      <MinimumDue>4</MinimumDue>
      <NextTxMinAmountDue>6</NextTxMinAmountDue>
      <PaymentMethod>sample string 12</PaymentMethod>
      <PrimaryAccountNo>sample string 11</PrimaryAccountNo>
      <RecordTypeName>sample string 10</RecordTypeName>
    </Charges>
  </Charges>
  <CustomerReferenceNumber>sample string 2</CustomerReferenceNumber>
  <InstantEFTContributionAmount>4</InstantEFTContributionAmount>
  <PaymentReference>sample string 1</PaymentReference>
  <PaymentTypeID>CreditCard</PaymentTypeID>
  <VendingPurchaseID>6cc674af-a51d-4b40-9360-38006869021d</VendingPurchaseID>
  <WalletContributionAmount>5</WalletContributionAmount>
</ValidatePaymentRequest>

application/x-www-form-urlencoded

Sample:

Failed to generate the sample for media type 'application/x-www-form-urlencoded'. Cannot use formatter 'JQueryMvcFormUrlEncodedFormatter' to write type 'ValidatePaymentRequest'.

Response Information

Resource Description

ValidatePaymentResponse

Name	Type	Additional information
PaymentReference	string	None.
Success	boolean	None.
ErrorMessage	string	None.
ServerDateTime	string	None.
ErrorType	Errors	None.

Response Formats

application/json, text/json

Sample:

{
  "PaymentReference": "sample string 1",
  "Success": true,
  "ErrorMessage": "sample string 3",
  "ServerDateTime": "sample string 4",
  "ErrorType": 0
}

application/xml, text/xml

Sample:

<ValidatePaymentResponse xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/PPWAssistMobileAPI.Models">
  <ErrorMessage>sample string 3</ErrorMessage>
  <ErrorType>SystemError</ErrorType>
  <ServerDateTime>sample string 4</ServerDateTime>
  <Success>true</Success>
  <PaymentReference>sample string 1</PaymentReference>
</ValidatePaymentResponse>