> For the complete documentation index, see [llms.txt](https://pivot-payment.gitbook.io/pivot-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://pivot-payment.gitbook.io/pivot-docs/api-references/api-lists/payments/object/order-object.md).

# Order Object

```json
{
  "orderInformation": {
    "productDetails": [
      {
        "type": "PHYSICAL",
        "category": "FASHION",
        "subCategory": "FASHION WANITA",
        "name": "Dress Kasual Warna Putih",
        "description": "Ukuran M",
        "quantity": 1,
        "price": {
          "value": 100000,
          "currency": "IDR"
        }
      }
    ],
    "billingInfo": { // Mandatory for Foreign Card with AVS
      "givenName": "Reforza Jordan",
      "surname": "Geotama",
      "email": "reforza@pivot-payment.com",
      "phoneNumber": {
        "countryCode": "+62",
        "number": "89699990001"
      },
      "addressLine1": "Biomedical Building Lantai 3",
      "addressLine2": "Digital hub, BSD City",
      "city": "Tangerang Regency",
      "provinceState": "Banten",
      "country": "ID",
      "postalCode": "15331"
    },
    "shippingInfo": {
      "givenName": "Reforza Jordan",
      "surname": "Geotama",
      "email": "reforza@pivot-payment.com",
      "phoneNumber": {
        "countryCode": "+62",
        "number": "89699990001"
      },
      "addressLine1": "Biomedical Building Lantai 3",
      "addressLine2": "Digital hub, BSD City",
      "city": "Tangerang Regency",
      "provinceState": "Banten",
      "country": "ID",
      "postalCode": "15331",
      "method": "REGULAR",
      "shippingFee": {
        "value": 100000,
        "currency": "IDR"
      }
    }
  }
}
```

**Detail Order Object**

<table><thead><tr><th width="230.53125">Parameter</th><th width="109.078125">Data Type</th><th width="129.548828125">Character Limit</th><th width="124.23828125">Requirement</th><th width="235.794921875">Description</th></tr></thead><tbody><tr><td>productDetails</td><td>Array of Objects</td><td>-</td><td>M</td><td>List of products included in the order</td></tr><tr><td><ul><li>type</li></ul></td><td>String</td><td>1-255</td><td>M</td><td><p>Product type, possible values:</p><ul><li>PHYSICAL</li><li>DIGITAL</li><li>SERVICE</li></ul></td></tr><tr><td><ul><li>category</li></ul></td><td>String</td><td>1-255</td><td>O</td><td>Main category of the product (e.g., FASHION)</td></tr><tr><td><ul><li>subCategory</li></ul></td><td>String</td><td>1-255</td><td>O</td><td>Further classification within the category</td></tr><tr><td><ul><li>name</li></ul></td><td>String</td><td>1-255</td><td>O</td><td>Product name</td></tr><tr><td><ul><li>description</li></ul></td><td>String</td><td>1-255</td><td>O</td><td>Additional details such as size or color</td></tr><tr><td><ul><li>quantity</li></ul></td><td>Float</td><td>1-18</td><td>M</td><td>Number of units for this product</td></tr><tr><td><ul><li>price</li></ul></td><td>Object</td><td>-</td><td>M</td><td>Unit price of the product</td></tr><tr><td><blockquote><ul><li>value</li></ul></blockquote></td><td>Float</td><td>1-18</td><td>M</td><td>Amount value</td></tr><tr><td><blockquote><ul><li>currency</li></ul></blockquote></td><td>String</td><td>1-3</td><td>M</td><td>Currency ISO 4217</td></tr><tr><td>billingInfo</td><td>Object</td><td>-</td><td>C</td><td>The details of the billing information<br><br>Mandatory for Foreign Card with AVS</td></tr><tr><td><ul><li>givenName</li></ul></td><td>String</td><td>1-255</td><td>M</td><td>First name of the billing name</td></tr><tr><td><ul><li>surname</li></ul></td><td>String</td><td>0-255</td><td>O</td><td>Last name of the billing name</td></tr><tr><td><ul><li>email</li></ul></td><td>String</td><td>1-255</td><td>M</td><td>Validate email format</td></tr><tr><td><ul><li>phoneNumber</li></ul></td><td>Object</td><td>-</td><td>O</td><td>Phone number information</td></tr><tr><td><blockquote><ul><li>CountryCode</li></ul></blockquote></td><td>String</td><td>1-255</td><td>M</td><td>Country code prefix (e.g., +62)</td></tr><tr><td><blockquote><ul><li>number</li></ul></blockquote></td><td>String</td><td>1-15</td><td>M</td><td>Phone number start with “8”</td></tr><tr><td><ul><li>addressLine1</li></ul></td><td>String</td><td>1-255</td><td>C</td><td>Primary street address<br><br>Mandatory for Foreign Card with AVS</td></tr><tr><td><ul><li>addressLine2</li></ul></td><td>String</td><td>0-255</td><td>O</td><td>Secondary address information</td></tr><tr><td><ul><li>city</li></ul></td><td>String</td><td>1-255</td><td>C</td><td>City or regency<br><br>Mandatory for Foreign Card with AVS</td></tr><tr><td><ul><li>provinceState</li></ul></td><td>String</td><td>1-255</td><td>C</td><td>Province or state name<br><br>Mandatory for Foreign Card with AVS</td></tr><tr><td><ul><li>country</li></ul></td><td>String</td><td>1-255</td><td>C</td><td>Country code (e.g., ID)<br>ISO 3166-2<br><br>Mandatory for Foreign Card with AVS</td></tr><tr><td><ul><li>postalCode</li></ul></td><td>String</td><td>0-255</td><td>C</td><td>Postal or ZIP code<br><br>Mandatory for Foreign Card with AVS</td></tr><tr><td>shippingInfo</td><td>Object</td><td>-</td><td>O</td><td>The details of the shipping information</td></tr><tr><td><ul><li>givenName</li></ul></td><td>String</td><td>1-255</td><td>M</td><td>First name of the billing name</td></tr><tr><td><ul><li>surname</li></ul></td><td>String</td><td>0-255</td><td>O</td><td>Last name of the billing name</td></tr><tr><td><ul><li>email</li></ul></td><td>String</td><td>1-255</td><td>M</td><td>Validate email format</td></tr><tr><td><ul><li>phoneNumber</li></ul></td><td>Object</td><td>-</td><td>O</td><td>Phone number information</td></tr><tr><td><blockquote><ul><li>CountryCode</li></ul></blockquote></td><td>String</td><td>2-4</td><td>M</td><td>Country code prefix (e.g., +62)</td></tr><tr><td><blockquote><ul><li>number</li></ul></blockquote></td><td>String</td><td>1-15</td><td>M</td><td>Phone number start with “8”</td></tr><tr><td><ul><li>addressLine1</li></ul></td><td>String</td><td>1-255</td><td>M</td><td>Primary street address</td></tr><tr><td><ul><li>addressLine2</li></ul></td><td>String</td><td>0-255</td><td>O</td><td>Secondary address information</td></tr><tr><td><ul><li>city</li></ul></td><td>String</td><td>1-255</td><td>M</td><td>City or regency</td></tr><tr><td><ul><li>provinceState</li></ul></td><td>String</td><td>1-255</td><td>M</td><td>Province or state name</td></tr><tr><td><ul><li>country</li></ul></td><td>String</td><td>1-255</td><td>M</td><td>Country code (e.g., ID)<br>ISO 3166-2</td></tr><tr><td><ul><li>postalCode</li></ul></td><td>String</td><td>0-255</td><td>O</td><td>Postal or ZIP cod</td></tr><tr><td><ul><li>method</li></ul></td><td>String</td><td>-</td><td>M</td><td><p>Shipping method, possible values:</p><ul><li>REGULAR</li><li>NEXTDAY</li><li>SAMEDAY</li><li>INSTANT</li></ul></td></tr><tr><td><ul><li>shippingFee</li></ul></td><td>Object</td><td>-</td><td>O</td><td>Shipping fee amount</td></tr><tr><td><blockquote><ul><li>value</li></ul></blockquote></td><td>Float</td><td>1-18</td><td>M</td><td>Amount value</td></tr><tr><td><blockquote><ul><li>currency</li></ul></blockquote></td><td>String</td><td>1-3</td><td>M</td><td>Currency ISO 4217</td></tr></tbody></table>