Data Models

Address Object

Attributes

  <th style={{ textAlign: "left" }}>
    Type
  </th>

  <th style={{ textAlign: "left" }}>
    Description
  </th>

  <th style={{ textAlign: "left" }}>
    Required
  </th>
</tr>
  <td style={{ textAlign: "left" }}>
    string
  </td>

  <td style={{ textAlign: "left" }}>
    Full name of contact. Limited to 300 characters
  </td>

  <td style={{ textAlign: "left" }}>
    <span style="display: block;text-align: center;">Y</span>
  </td>
</tr>

<tr>
  <td style={{ textAlign: "left" }}>
    line1
  </td>

  <td style={{ textAlign: "left" }}>
    string
  </td>

  <td style={{ textAlign: "left" }}>
    Address Line1
  </td>

  <td style={{ textAlign: "left" }}>
    <span style="display: block;text-align: center;">Y</span>
  </td>
</tr>

<tr>
  <td style={{ textAlign: "left" }}>
    line2
  </td>

  <td style={{ textAlign: "left" }}>
    string
  </td>

  <td style={{ textAlign: "left" }}>
    Address Line 2
  </td>

  <td style={{ textAlign: "left" }}>

  </td>
</tr>

<tr>
  <td style={{ textAlign: "left" }}>
    area1
  </td>

  <td style={{ textAlign: "left" }}>
    string
  </td>

  <td style={{ textAlign: "left" }}>
    Australian suburb
  </td>

  <td style={{ textAlign: "left" }}>

  </td>
</tr>

<tr>
  <td style={{ textAlign: "left" }}>
    area2
  </td>

  <td style={{ textAlign: "left" }}>
    string
  </td>

  <td style={{ textAlign: "left" }}>

  </td>

  <td style={{ textAlign: "left" }}>

  </td>
</tr>

<tr>
  <td style={{ textAlign: "left" }}>
    region
  </td>

  <td style={{ textAlign: "left" }}>
    string
  </td>

  <td style={{ textAlign: "left" }}>
    Austaralian State
  </td>

  <td style={{ textAlign: "left" }}>
    <span style="display: block;text-align: center;">Y</span>
  </td>
</tr>

<tr>
  <td style={{ textAlign: "left" }}>
    postcode
  </td>

  <td style={{ textAlign: "left" }}>
    string
  </td>

  <td style={{ textAlign: "left" }}>
    Zip or post code
  </td>

  <td style={{ textAlign: "left" }}>
    <span style="display: block;text-align: center;">Y</span>
  </td>
</tr>

<tr>
  <td style={{ textAlign: "left" }}>
    countryCode
  </td>

  <td style={{ textAlign: "left" }}>
    string
  </td>

  <td style={{ textAlign: "left" }}>
    Two digit country Code  - AU
  </td>

  <td style={{ textAlign: "left" }}>
    <span style="display: block;text-align: center;">Y</span>
  </td>
</tr>

<tr>
  <td style={{ textAlign: "left" }}>
    phoneNumber
  </td>

  <td style={{ textAlign: "left" }}>
    string
  </td>

  <td style={{ textAlign: "left" }}>
    Phone Number
  </td>

  <td style={{ textAlign: "left" }}>

  </td>
</tr>
Attribute
name

Example of Address Object

{
   	"name": "Test",
        "line1": "Level 15",
        "line2": "Kent st",
        "area1": "Sydney",
        "area2": null,
        "region": "NSW",
        "postCode": "2000",
        "countryCode": "AU",
        "phoneNumber": "0456866769"
}

Customer Object

Attributes

  <th>
    Type
  </th>

  <th>
    Description
  </th>

  <th>
    Required
  </th>
</tr>
  <td>
    string
  </td>

  <td>
    Customer phone number. Limited to 15 characters
  </td>

  <td>

  </td>
</tr>

<tr>
  <td>
    givenNames
  </td>

  <td>
    string
  </td>

  <td>
    Customer First Name/Given Name. Limited to 100 characters
  </td>

  <td>

  </td>
</tr>

<tr>
  <td>
    surname
  </td>

  <td>
    string
  </td>

  <td>
    Customer Last Name/surname. Limited to 100 characters
  </td>

  <td>

  </td>
</tr>

<tr>
  <td>
    email
  </td>

  <td>
    string
  </td>

  <td>
    Customer Email address. Limited to 300 characters
  </td>

  <td>
    <span style="display: block;text-align: center;">Y</span>
  </td>
</tr>
Attribute
phoneNumber

Example of Customer Object

{
  "phoneNumber": "0456 000 000",
  "givenNames": "Joe",
  "surname": "Customer",
  "email": "[email protected]"
}

Money Object

ATTRIBUTES

  <th>
    Type
  </th>

  <th>
    Description
  </th>

  <th>
    Required
  </th>
</tr>
  <td>
    string
  </td>

  <td>
    The amount is a string representation of a decimal number, rounded to 2 decimal places.
  </td>

  <td>
    <span style="display: block;text-align: center;">Y</span>
  </td>
</tr>

<tr>
  <td>
    currency
  </td>

  <td>
    string
  </td>

  <td>
    The currency in <a href="https://en.wikipedia.org/wiki/ISO_4217" target="_blank">ISO 4217</a> format. Currently it support only “AUD”. However, the value provided MUST correspond to the currency of the Merchant account making the request.
  </td>

  <td>
    <span style="display: block;text-align: center;">Y</span>
  </td>
</tr>
Attribute
amount

Example of Money Object

{
  "amount": "29.99",
  "currency": "AUD"
}

Discount Object

ATTRIBUTES

  <th>
    Type
  </th>

  <th>
    Description
  </th>

  <th>
    Required
  </th>
</tr>
  <td>
    string
  </td>

  <td>
    A display name for the discount. Limited to 150 characters.
  </td>

  <td>
    <span style="display: block;text-align: center;">Y</span>
  </td>
</tr>

<tr>
  <td>
    amount
  </td>

  <td>
    <a href="#money-object">Money</a>
  </td>

  <td>
    The discount amount.
  </td>

  <td>
    <span style="display: block;text-align: center;">Y</span>
  </td>
</tr>
Attribute
displayName

Example of Discount Object

{
  "displayName": "New Customer Coupon",
  "amount": {
    "amount": "29.99",
    "currency": "AUD"
  }
}

Item Object

ATTRIBUTES

  <th>
    Type
  </th>

  <th>
    Description
  </th>

  <th>
    Required
  </th>
</tr>
  <td>
    string
  </td>

  <td>
    Item Name. Limited to 300 characters
  </td>

  <td>
    <span style="display: block;text-align: center;">Y</span>
  </td>
</tr>

<tr>
  <td>
    sku
  </td>

  <td>
    string
  </td>

  <td>
    Product SKU. Limited to 150 characters.
  </td>

  <td>

  </td>
</tr>

<tr>
  <td>
    quantity
  </td>

  <td>
    integer
  </td>

  <td>
    The quantity of the item, stored as a signed 32-bit integer.
  </td>

  <td>
    <span style="display: block;text-align: center;">Y</span>
  </td>
</tr>

<tr>
  <td>
    pageURL
  </td>

  <td>
    string
  </td>

  <td>
    URL for the item's Product Detail Page. Limited to 1500 characters
  </td>

  <td>

  </td>
</tr>

<tr>
  <td>
    imageURL
  </td>

  <td>
    string
  </td>

  <td>
    A  URL for a web-optimised photo of the item, suitable for use directly as the src attribute of an img tag. Limited to 1500 characters
  </td>

  <td>

  </td>
</tr>

<tr>
  <td>
    price
  </td>

  <td>
    <a href="#money-object">Money</a>
  </td>

  <td>
    The unit price of the individual item. Must be a positive value.
  </td>

  <td>
    <span style="display: block;text-align: center;">Y</span>
  </td>
</tr>

<tr>
  <td>
    categories
  </td>

  <td>
    string [][]
  </td>

  <td>
    An array of arrays to accommodate multiple categories that apply to the item. Each array represents a hierarchical path to a category, with the left-most category being the top-level parent category.
  </td>

  <td>

  </td>
</tr>
Attribute
name

Example of Item Object

{
            "name": "Item1",
            "sku": "SKU-003",
            "quantity": 1,
            "pageURL": "https://page.com.au",
            "imageURL": "Https://image.com.au",
            "price": {
                "amount": 24.0000,
                "currency": "AUD"
                  },            
     "categories ":  [
    ["SPORTING GOODS", "CLIMBING EQUIPMENT", "CLIMBING", "CLIMBING CARABINERS"],
    ["SALE", "CLIMBING"]
      ]
}

Merchant URL Object

ATTRIBUTES

  <th>
    Type
  </th>

  <th>
    Description
  </th>

  <th>
    Required
  </th>
</tr>
  <td>
    string
  </td>

  <td>
    Customer will be redirected to this URL if wizit approve the purchase and first payment is complete
  </td>

  <td>
    <span style="display: block;text-align: center;">Y</span>
  </td>
</tr>

<tr>
  <td>
    redirectCancelURL
  </td>

  <td>
    string
  </td>

  <td>
    Customer will be redirected to this URL if wizit decline the purchase
  </td>

  <td>
    <span style="display: block;text-align: center;">Y</span>
  </td>
</tr>
Attribute
redirectConfirmURL

Example of Merchant URL Object

{
        "redirectConfirmURL": "https://confirm.com.au",
        "redirectCancelURL": "https://cancel.com.au"
   }

Courier Object

ATTRIBUTES

  <th>
    Type
  </th>

  <th>
    Description
  </th>
</tr>
  <td>
    string
  </td>

  <td>
    Shipping date. Format YYYY-MMDD
  </td>
</tr>

<tr>
  <td>
    name
  </td>

  <td>
    string
  </td>

  <td>
    Courier Name. Limited to 200 characters
  </td>
</tr>

<tr>
  <td>
    tracking
  </td>

  <td>
    string
  </td>

  <td>
    Tracking Number provided by Courier. Limited to 50 Characters
  </td>
</tr>

<tr>
  <td>
    priority
  </td>

  <td>
    string
  </td>

  <td>
    Shipping priority. Can be Either STANDARD" or "EXPRESS".
  </td>
</tr>
Attribute
shippedAt

Example of Courier Object

{
        "shippedAt": "2021-07-22T00:00:00",
        "name": null,
        "tracking": "TRACK_800",
        "priority": null
}

Transaction Detail Object

ATTRIBUTES

  <th>
    Type
  </th>

  <th>
    Description
  </th>

  <th>
    Required
  </th>
</tr>
  <td>
    <a href="#money-object">Money</a>
  </td>

  <td>
    Total amount payable by customer
  </td>

  <td>
    <span style="display: block;text-align: center;">Y</span>
  </td>
</tr>

<tr>
  <td>
    description
  </td>

  <td>
    string
  </td>

  <td>
    Order description
  </td>

  <td>

  </td>
</tr>

<tr>
  <td>
    Customer
  </td>

  <td>
    <a href="#customer-object">Customer</a>
  </td>

  <td>
    Customer details
  </td>

  <td>
    <span style="display: block;text-align: center;">Y</span>
  </td>
</tr>

<tr>
  <td>
    Billing
  </td>

  <td>
    <a href="#address-object">Address</a>
  </td>

  <td>
    Customer’s Billing Address
  </td>

  <td>

  </td>
</tr>

<tr>
  <td>
    Shipping
  </td>

  <td>
    <a href="#address-object">Address</a>
  </td>

  <td>
    Customer’s Shipping Address
  </td>

  <td>
    <span style="display: block;text-align: center;">Y</span>
  </td>
</tr>

<tr>
  <td>
    Courier
  </td>

  <td>
    <a href="#courier-object">Courier</a>
  </td>

  <td>
    Customer’s  chosen Courier details
  </td>

  <td>

  </td>
</tr>

<tr>
  <td>
    Items
  </td>

  <td>
    <a href="#item-object">Item </a>\[]
  </td>

  <td>
    Array of items in the order
  </td>

  <td>

  </td>
</tr>

<tr>
  <td>
    Discounts
  </td>

  <td>
    <a href="#discount-object">Discount</a>\[]
  </td>

  <td>
    List of discounts (if any)
  </td>

  <td>

  </td>
</tr>

<tr>
  <td>
    merchantReference
  </td>

  <td>
    String
  </td>

  <td>
    Unique Reference Number from merchant for the order
  </td>

  <td>
    <span style="display: block;text-align: center;">Y</span>
  </td>
</tr>

<tr>
  <td>
    merchantOrderId
  </td>

  <td>
    String
  </td>

  <td>
    Order number at merchant side
  </td>

  <td>

  </td>
</tr>

<tr>
  <td>
    TaxAmount
  </td>

  <td>
    <a href="#money-object">Money</a>
  </td>

  <td>
    Tax Amount after discounts (if any)
  </td>

  <td>

  </td>
</tr>

<tr>
  <td>
    ShippingAmount
  </td>

  <td>
    <a href="#money-object">Money</a>
  </td>

  <td>
    Shopping price charged to the customer
  </td>

  <td>

  </td>
</tr>

<tr>
  <td>
    merchant
  </td>

  <td>
    <a href="#merchanturl-object">MerchantURL</a>
  </td>

  <td>
    Merchant redirection confirm/cancel URL
  </td>

  <td>

  </td>
</tr>
Order
amount

Example of Transaction Detail Object

{
   
    "amount": {
        "amount":41.14,
        "currency": "AUD"
    },
    "customer": {
        "phoneNumber": "0414466667",
        "givenNames": "FP",
        "surname": "LoanCreate",
        "email": "[email protected]"
    },
    "billing": {
        "name": "Billing Add",
        "line1": "Level 15",
        "line2": "Kent st",
        "area1": "Sydney",
        "area2": null,
        "region": "NSW",
        "postCode": "2000",
        "countryCode": "AU",
        "phoneNumber": "0456866770"
    },
    "shipping": {
        "name": "Test",
        "line1": "Level 15",
        "line2": "Kent st",
        "area1": "Sydney",
        "area2": null,
        "region": "NSW",
        "postCode": "2000",
        "countryCode": "AU",
        "phoneNumber": "0456866769"
    },
    "courier": {
        "shippedAt": "2021-07-22T00:00:00",
        "name": null,
        "tracking": "TRACK_800",
        "priority": null
    },
    "description": "Test orde 2",
    "items": [
        {
            "name": "Item1",
            "sku": "SKU-003",
            "quantity": 1,
            "pageURL": "https://page.com.au",
            "imageURL": "Https://image.com.au",
            "price": {
                "amount": 24.0000,
                "currency": "AUD"
            },
            
            "CATEGORIES":  [
    ["SPORTING GOODS", "CLIMBING EQUIPMENT", "CLIMBING", "CLIMBING CARABINERS"],
    ["SALE", "CLIMBING"]
  ]
        }
    ],
    "discounts": [
        {
            "displayName": null,
            "discountNumber": 0,
            "amount": {
                "amount": 2.0000,
                "currency": "AUD"
            }
        }
    ],
    "merchant": {
        "redirectConfirmURL": "https://confirm.com.au",
        "redirectCancelURL": "https://cancel.com.au"
    },
    "merchantReference": "MER-202107090007",
    "merchantOrderId": "20114",
    "taxAmount": {
        "amount": 2.0000,
        "currency": "AUD"
    },
    "shippingAmount": {
        "amount": 10.00,
        "currency": "AUD"
    }
   
}

Refund Object

ATTRIBUTES

  <th>
    Type
  </th>

  <th>
    Description
  </th>

  <th>
    Required
  </th>
</tr>
  <td>
    string
  </td>

  <td>
    A unique request ID, required (in conjunction with merchantReference) for safe retries. It is recommended that the merchant generate a UUID for each unique refund.
  </td>

  <td>

  </td>
</tr>

<tr>
  <td>
    amount
  </td>

  <td>
    <a href="#money-object">Money</a>
  </td>

  <td>
    The refund amount.
  </td>

  <td>
    <span style="display: block;text-align: center;">Y</span>
  </td>
</tr>

<tr>
  <td>
    merchantReference
  </td>

  <td>
    string
  </td>

  <td>
    The merchant's corresponding refund ID or reference, required (in conjunction with requestId) for safe retries.
  </td>

  <td>

  </td>
</tr>

<tr>
  <td>
    refundId
  </td>

  <td>
    string
  </td>

  <td>
    The unique, Wizit-generated refund ID.
  </td>

  <td>

  </td>
</tr>

<tr>
  <td>
    refundedAt
  </td>

  <td>
    string
  </td>

  <td>
    AEST timestamp of the refund creation time, in ISO 8601 format.
  </td>

  <td>

  </td>
</tr>

<tr>
  <td>
    refundMerchantReference
  </td>

  <td>
    string
  </td>

  <td>
    A unique reference for the individual refund event. If provided, the value will appear in the reference column of settlement file.
  </td>

  <td>

  </td>
</tr>

<tr>
  <td>
    TransactionId
  </td>

  <td>
    long
  </td>

  <td>
    The unique, permanent, Wizit-generated transaction ID.
  </td>

  <td>

  </td>
</tr>
Attribute
requestId

Example of Refund Object

{
  "requestId" : "49efce77-4bf2-4e41-86e8-c2b92f493c2a",
  "amount" : {  
    "amount" : "10.00",
    "currency" : "AUD"
  },
  "merchantReference" : "merchantRefundId-1234",
  "refundId" : "67890123",
  "refundedAt" : "2019-01-01T00:00:00.000Z",
  "refundMerchantReference" : "merchantRefundId-1234",
  "transactionId": "12611",
}

Payment Object

Attributes

  <th>
    Type
  </th>

  <th>
    Description
  </th>
</tr>
  <td>
    string
  </td>

  <td>
    The unique, permanent, Wizit-generated transaction ID.
  </td>
</tr>

<tr>
  <td>
    token
  </td>

  <td>
    string
  </td>

  <td>
    Checkout token that was used to complete payment.
  </td>
</tr>

<tr>
  <td>
    transactionStatus
  </td>

  <td>
    string
  </td>

  <td>
    An order status of "APPROVED" or "DECLINED" or COMPLETED (captured completed/voided)
  </td>
</tr>

<tr>
  <td>
    paymentCompleted
  </td>

  <td>
    string
  </td>

  <td>
    The AEST timestamp of when the payment was completed, in <a href="https://www.iso.org/iso-8601-date-and-time-format.html" target="_blank">ISO 8601</a> format.
  </td>
</tr>

<tr>
  <td>
    OriginalAmount
  </td>

  <td>
    <a href="#money-object">Money</a>
  </td>

  <td>
    Total amount charged to the customer for the order.
  </td>
</tr>

<tr>
  <td>
    pendingCaptureAmount
  </td>

  <td>
    <a href="#money-object">Money</a>
  </td>

  <td>
    Remaining amount that can be captured. Will always be zero for <a href="/reference/post_api-payment-transactioncapture">Immediate Payment Flow</a> orders.
  </td>
</tr>

<tr>
  <td>
    paymentStatus
  </td>

  <td>
    string
  </td>

  <td>
    Current state for capturing payments. Will be one of: "AUTH\_APPROVED", "AUTH\_DECLINED", "PARTIALLY\_CAPTURED", "CAPTURED", "CAPTURE\_DECLINED",\
    "VOIDED".
  </td>
</tr>

<tr>
  <td>
    merchantReference
  </td>

  <td>
    string
  </td>

  <td>
    The merchant's order id/reference that this payment corresponds to.
  </td>
</tr>

<tr>
  <td>
    refunds
  </td>

  <td>
    <a href="#refund-object">Refund</a>\[]
  </td>

  <td>
    An array of refunds.
  </td>
</tr>

<tr>
  <td>
    transactionDetails
  </td>

  <td>
    <a href="#transactiondetail-object">TransactionDetail</a>
  </td>

  <td>
    The details of the order bound to the payment.
  </td>
</tr>
Attribute
transactionId

Example of Payment Object

{
    "transactionId": "12611",
    "token": "ca25b39b-3873-43ff-8682-e40651e52bb7",
    "transactionStatus": "COMPLETED",
    "paymentCompleted": "2021-07-26 09:30:44",
    "originalAmount": {
        "amount": 425.39,
        "currency": "AUD"
    },
    "pendingCaptureAmount": {
        "amount": 0.0,
        "currency": "AUD"
    },
    "paymentStatus": "CAPTURED",
    "merchantReference": "MERb8ad930346fa5231350110d8f21bc0f1-435",
    "transactionDetails": {
        "billing": {
            "name": "k",
            "line1": "sdf",
            "line2": "",
            "area1": "sdf",
            "area2": null,
            "region": "NSW",
            "postCode": "SDF",
            "countryCode": "AU",
            "phoneNumber": "0157845466"
        },
        "shipping": {
            "name": "k",
            "line1": "sdf",
            "line2": "",
            "area1": "sdf",
            "area2": null,
            "region": "NSW",
            "postCode": "SDF",
            "countryCode": "AU",
            "phoneNumber": "0157845466"
        },
        "courier": null,
        "items": [
            {
                "name": "Shoes (Pre-Owned)",
                "sku": "",
                "quantity": 1,
                "pageURL": null,
                "imageURL": null,
                "price": {
                    "amount": 349.99,
                    "currency": "AUD"
                },
                "categories": null
            },
            {
                "name": "Instagram Egg",
                "sku": "",
                "quantity": 1,
                "pageURL": null,
                "imageURL": null,
                "price": {
                    "amount": 0.40,
                    "currency": "AUD"
                },
                "categories": null
            },
            {
                "name": "Hat",
                "sku": "",
                "quantity": 3,
                "pageURL": null,
                "imageURL": null,
                "price": {
                    "amount": 75.00,
                    "currency": "AUD"
                },
                "categories": null
            }
        ],
        "discounts": [
            {
                "displayName": null,
                "amount": {
                    "amount": 0.00,
                    "currency": "AUD"
                }
            }
        ],
        "taxAmount": {
            "amount": 0.00,
            "currency": "AUD"
        },
        "shippingAmount": {
            "amount": 0.00,
            "currency": "AUD"
        },
        "customer": {
            "phoneNumber": "0157845466",
            "givenNames": "k",
            "surname": "db",
            "email": "[email protected]"
        }
    },
    "paymentDescription": "",
    "refunds": null,
    "responseCode": 200,
    "errorCode": null,
    "errorMessage": null
}

Pagination Object

Attributes

  <th>
    Type
  </th>

  <th>
    Description
  </th>
</tr>
  <td>
    Int32
  </td>

  <td>
    Page Number of list/response
  </td>
</tr>

<tr>
  <td>
    pageSize
  </td>

  <td>
    Int32
  </td>

  <td>
    Page size of the list/response
  </td>
</tr>

<tr>
  <td>
    totalPages
  </td>

  <td>
    Int32
  </td>

  <td>
    Total Number of pages in the list/response
  </td>
</tr>

<tr>
  <td>
    responseCode
  </td>

  <td>
    string
  </td>

  <td>
    Response code for the request. Refer <a href="/docs/response-codes">Response code</a>
  </td>
</tr>

<tr>
  <td>
    errorCode
  </td>

  <td>
    string
  </td>

  <td>
    Error code (if any) for the request. Refer <a href="/docs/errors-codes">Error code</a>
  </td>
</tr>

<tr>
  <td>
    errorMessage
  </td>

  <td>
    string
  </td>

  <td>
    Error Message (if any) for the request. Refer <a href="/docs/errors-codes">Error Message</a>
  </td>
</tr>
Attribute
pageNo

Example of Pagination Object

"responseCode": “200”,
  "errorCode": null,
  "errorMessage": null,
  "pageNo": 1,
  "pageSize": 20,
  "totalPages": 20
}