# ConfirmPaymentRequest

**paymentToken**Payment-PaymentTokenrequired

A payment token generated by monei.js [Components](https://docs.monei.com/monei-js/overview/) or a paymentToken [saved after a previous successful payment](https://docs.monei.com/guides/save-payment-method/).

**Example:<!-- -->&#x20;**`7cc38b08ff471ccd313ad62b23b9f362b107560b`

**paymentMethod** <!-- -->object

Additional information about the payment method used for this payment.

**card** <!-- -->object

Additional information about the card used for this payment.

**cardholderName**CardholderName

The cardholder's name, as stated in the credit card.

**Example:<!-- -->&#x20;**`John Doe`

**cardholderEmail**CardholderEmail

The cardholder's email address.

**Example:<!-- -->&#x20;**`john.doe@monei.com`

**generatePaymentToken**Payment-GeneratePaymentToken

If set to true a permanent token that represents a payment method used in the payment will be generated.

**Default value:<!-- -->&#x20;**`false`

**Example:<!-- -->&#x20;**`false`

**customer** <!-- -->object

**email**string

The customer's email address.

**Example:<!-- -->&#x20;**`john.doe@example.com`

**name**string

The customer's full name or business name.

**Example:<!-- -->&#x20;**`John Doe`

**phone**string

The customer's phone number in E.164 format.

**Example:<!-- -->&#x20;**`null`

**billingDetails** <!-- -->object

Billing information associated with the payment method at the time of the transaction.

**name**string

The customer's billing full name.

**Example:<!-- -->&#x20;**`John Doe`

**email**string

The customer's billing email address.

**Example:<!-- -->&#x20;**`john.doe@example.com`

**phone**string

The customer's billing phone number in E.164 format.

**Example:<!-- -->&#x20;**`null`

**company**string

Billing company name.

**Example:<!-- -->&#x20;**`null`

**taxId**string

Company tax ID.

**Example:<!-- -->&#x20;**`null`

**address** <!-- -->object

**country**Country

Two-letter country code ([ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2)).

**Example:<!-- -->&#x20;**`ES`

**city**string

City, district, suburb, town, or village.

**Example:<!-- -->&#x20;**`Málaga`

**line1**string

Address line 1 (e.g., street, PO Box, or company name).

**Example:<!-- -->&#x20;**`Fake Street 123`

**line2**string

Address line 2 (e.g., apartment, suite, unit, or building).

**Example:<!-- -->&#x20;**`null`

**zip**string

ZIP or postal code.

**Example:<!-- -->&#x20;**`1234`

**state**string

State, county, province, or region.

**Example:<!-- -->&#x20;**`Málaga`

**shippingDetails** <!-- -->object

Shipping information associated with the payment.

**name**string

The shipping customer's full name.

**Example:<!-- -->&#x20;**`John Doe`

**email**string

The shipping customer's email address.

**Example:<!-- -->&#x20;**`john.doe@example.com`

**phone**string

The shipping customer's phone number in E.164 format.

**Example:<!-- -->&#x20;**`null`

**company**string

Name of the company where the shipment is going.

**Example:<!-- -->&#x20;**`null`

**taxId**string

Company tax ID.

**Example:<!-- -->&#x20;**`null`

**address** <!-- -->object

**country**Country

Two-letter country code ([ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2)).

**Example:<!-- -->&#x20;**`ES`

**city**string

City, district, suburb, town, or village.

**Example:<!-- -->&#x20;**`Málaga`

**line1**string

Address line 1 (e.g., street, PO Box, or company name).

**Example:<!-- -->&#x20;**`Fake Street 123`

**line2**string

Address line 2 (e.g., apartment, suite, unit, or building).

**Example:<!-- -->&#x20;**`null`

**zip**string

ZIP or postal code.

**Example:<!-- -->&#x20;**`1234`

**state**string

State, county, province, or region.

**Example:<!-- -->&#x20;**`Málaga`

**sessionDetails** <!-- -->Payment-SessionDetails

Information related to the browsing session of the user who initiated the payment.

**ip**IP

The IP address where the operation originated.

**Example:<!-- -->&#x20;**`100.100.200.100`

**countryCode**Country

Two-letter country code ([ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2)).

**Example:<!-- -->&#x20;**`ES`

**lang**Lang

Two-letter language code ([ISO 639-1](https://en.wikipedia.org/wiki/ISO_639-1)).

**Example:<!-- -->&#x20;**`es`

**deviceType**DeviceType

Device type, could be `desktop`, `mobile`, `smartTV`, `tablet`.

**Example:<!-- -->&#x20;**`desktop`

**deviceModel**DeviceModel

Information about the device used for the browser session (e.g., `iPhone`).

**Example:<!-- -->&#x20;**`null`

**browser**Browser

The browser used in this browser session (e.g., `Mobile Safari`).

**Example:<!-- -->&#x20;**`Chrome`

**browserVersion**BrowserVersion

The version for the browser session (e.g., `13.1.1`).

**Example:<!-- -->&#x20;**`83.0.4103.116`

**os**Os

Operation system (e.g., `iOS`).

**Example:<!-- -->&#x20;**`Mac OS`

**osVersion**OsVersion

Operation system version (e.g., `13.5.1`).

**Example:<!-- -->&#x20;**`10.15.4`

**source**Source

The source component from where the operation was generated (mostly for our SDK's).

**Example:<!-- -->&#x20;**`MONEI/PHP`

**sourceVersion**SourceVersion

The source component version from where the operation was generated (mostly for our SDK's).

**Example:<!-- -->&#x20;**`0.1.2`

**userAgent**UserAgent

Full user agent string of the browser session.

**Example:<!-- -->&#x20;**`Mozilla/5.0 (Windows NT 10.0; Win64; x64) ...`

**browserAccept**BrowserAccept

Browser accept header.

**Example:<!-- -->&#x20;**`text/html,application/xhtml+xml,application/json`

**browserColorDepth**BrowserColorDepth

The color depth of the browser session (e.g., `24`).

**Example:<!-- -->&#x20;**`24`

**browserScreenHeight**BrowserScreenHeight

The screen height of the browser session (e.g., `1152`).

**Example:<!-- -->&#x20;**`1152`

**browserScreenWidth**BrowserScreenWidth

The screen width of the browser session (e.g., `2048`).

**Example:<!-- -->&#x20;**`2048`

**browserTimezoneOffset**BrowserTimezoneOffset

The timezone offset of the browser session (e.g., `-120`).

**Example:<!-- -->&#x20;**`-120`

**metadata**object

A set of key-value pairs that you can attach to a resource. This can be useful for storing additional information about the resource in a structured format.

**Example:<!-- -->&#x20;**`{"systemId":"12345"}`

ConfirmPaymentRequest

```
{

  "paymentToken": "7cc38b08ff471ccd313ad62b23b9f362b107560b",

  "paymentMethod": {

    "card": {

      "cardholderName": "John Doe",

      "cardholderEmail": "john.doe@monei.com"

    }

  },

  "generatePaymentToken": false,

  "customer": {

    "email": "john.doe@example.com",

    "name": "John Doe",

    "phone": null

  },

  "billingDetails": {

    "name": "John Doe",

    "email": "john.doe@example.com",

    "phone": null,

    "company": null,

    "taxId": null,

    "address": {

      "country": "ES",

      "city": "Málaga",

      "line1": "Fake Street 123",

      "line2": null,

      "zip": "1234",

      "state": "Málaga"

    }

  },

  "shippingDetails": {

    "name": "John Doe",

    "email": "john.doe@example.com",

    "phone": null,

    "company": null,

    "taxId": null,

    "address": {

      "country": "ES",

      "city": "Málaga",

      "line1": "Fake Street 123",

      "line2": null,

      "zip": "1234",

      "state": "Málaga"

    }

  },

  "sessionDetails": {

    "ip": "100.100.200.100",

    "countryCode": "ES",

    "lang": "es",

    "deviceType": "desktop",

    "deviceModel": null,

    "browser": "Chrome",

    "browserVersion": "83.0.4103.116",

    "os": "Mac OS",

    "osVersion": "10.15.4",

    "source": "MONEI/PHP",

    "sourceVersion": "0.1.2",

    "userAgent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) ...",

    "browserAccept": "text/html,application/xhtml+xml,application/json",

    "browserColorDepth": "24",

    "browserScreenHeight": "1152",

    "browserScreenWidth": "2048",

    "browserTimezoneOffset": "-120"

  },

  "metadata": {

    "systemId": "12345"

  }

}
```
