> 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/core-resources/customers/customer-object.md).

# Customer Object

```json
{
  "customer": {
    "givenName": "Reforza Jordan",
    "surname": "Geotama",
    "email": "reforza@pivot-payment.com",
    "phoneNumber": {
      "countryCode": "+62",
      "number": "89699990001"
    },
    "refundPreference": {
      "method": "AUTO",
      "transferDestination": {
        "channelCode": "014",
        "channelInformation": {
          "accountNumber": "17677665415",
          "accountName": "Reforza Jordan Geotama"
        }
      }
    },
    "storedPaymentMethods": [
      {
        "token": "020027de-134e-45ed-8f0d-7ae0506a7133",
        "paymentMethod": "CARD",
        "paymentChannel": "VISA",
        "createdAt": "2025-09-02T06:02:59.141590124Z",
        "status": "ACTIVE",
        "card": {
          "fingerprint": "0198edcf-87a0-73fd-b937-7ec4b0ddb9c6",
          "network": "VISA",
          "first6": "444000",
          "first8": "44400001",
          "last4": "0002",
          "expMonth": "01",
          "expYear": "39",
          "cardHolderFirstName": "Reforza Jordan",
          "cardHolderLastName": "Geotama"
        }
      },
      {
        "token": "bicbiweu63c",
        "paymentMethod": "ewallet",
        "paymentChannel": "dana",
        "createdAt": "2024-03-15T09:37:00Z",
        "status": "ACTIVE"
      }
    ]
  }
}
```

**Detail Customer Object**

<table><thead><tr><th width="284.2861328125">Parameter</th><th width="109.078125">Data Type</th><th width="134.529296875">Character Limit</th><th width="124.23828125">Requirement</th><th width="198.458984375">Description</th></tr></thead><tbody><tr><td>givenName</td><td>String</td><td>1-255</td><td>O</td><td>First name of the customer</td></tr><tr><td>surname</td><td>String</td><td>0-255</td><td>O</td><td>Last name of the customer</td></tr><tr><td>email</td><td>String</td><td>1-255</td><td>M</td><td>Unique identifier of the customer</td></tr><tr><td>phoneNumber</td><td>Object</td><td>-</td><td>O</td><td>Phone number information</td></tr><tr><td><ul><li>countryCode</li></ul></td><td>String</td><td>1-4</td><td>M</td><td>Country code prefix (e.g., +62)</td></tr><tr><td><ul><li>number</li></ul></td><td>String</td><td>1-15</td><td>M</td><td>Phone number start with “8”</td></tr><tr><td>refundPreference</td><td>Object</td><td>-</td><td>O</td><td>Preferred refund method settings</td></tr><tr><td><ul><li>method</li></ul></td><td>String</td><td>-</td><td>M</td><td><p>Refund method preferred by Merchant / Customer, possible values:</p><p></p><ul><li>AUTO (default) :  Pivot will perform refund through Channel, if failed then fallback to Bank Transfer if available</li><li>TRANSFER_ONLY : Refund will be performed through Bank Transfer only, Merchant is required to send the destination account</li></ul></td></tr><tr><td><ul><li>transferDestination</li></ul></td><td>Object</td><td>-</td><td>C</td><td>Required if method = TRANSFER_ONLY</td></tr><tr><td><blockquote><ul><li> channelCode</li></ul></blockquote></td><td>String</td><td>1-20</td><td>M</td><td><p>Channel code for payout destination such as Bank, E wallet or other channels</p><p><br>List of Channel code can be accessed <a href="/pivot-docs/api-references/api-lists/payout-local/channel-codes.md">here</a></p></td></tr><tr><td><blockquote><ul><li>channelInformation</li></ul></blockquote></td><td>Object</td><td>-</td><td>M</td><td></td></tr><tr><td><blockquote><blockquote><ul><li>accountNumber</li></ul></blockquote></blockquote></td><td>String</td><td>1-30</td><td>M</td><td>Account Number of payout destination</td></tr><tr><td><blockquote><blockquote><ul><li>accountName</li></ul></blockquote></blockquote></td><td>String</td><td>1-50</td><td>M</td><td>Account Name of payout destination from the Merchant</td></tr><tr><td>storedPaymentMethods</td><td>Array of Objects</td><td>-</td><td>O</td><td>List of tokenized payment methods stored under this customer profile<br><br>*Shown on response only</td></tr><tr><td><ul><li>token</li></ul></td><td>String</td><td>20-100</td><td>M</td><td>Token ID representing the saved payment method<br><br>*Shown on response only</td></tr><tr><td><ul><li>paymentMethod</li></ul></td><td>String</td><td>-</td><td>M</td><td>Type of payment method (e.g., ewallet, cards)<br><br>*Shown on response only</td></tr><tr><td><ul><li>paymentChannel</li></ul></td><td>String</td><td>-</td><td>M</td><td>Payment provider (e.g., dana, visa)<br><br>*Shown on response only</td></tr><tr><td><ul><li>createdAt</li></ul></td><td>String</td><td>-</td><td>M</td><td>Timestamp of when the token was created (ISO 8601 format)<br><br>*Shown on response only</td></tr><tr><td><ul><li>status</li></ul></td><td>String</td><td>-</td><td>M</td><td><p>Token status, possible values:</p><ul><li>ACTIVE</li><li>INACTIVE</li></ul><p><br>*Shown on response only</p></td></tr><tr><td><ul><li>card</li></ul></td><td>Object</td><td>-</td><td>M</td><td><a data-mention href="/pivot-docs/api-references/api-lists/payments/object/charge-object/card-charge-object.md">Card Charge Object</a></td></tr></tbody></table>