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

# Attributes of the Request

Most of the request of Firstoken Payments API, has some of the following attributes

**transaction\_info** *{object}*

> Required: true
>
> Represents the information details of the request in a JSON object. The object has the following attributes:
>
> * **type**: string\
>   Type value represent the type of request that is sent.
>
>   Example: “authorization”
>
>   *Required*: true
> * **reference\_code**: string\
>   Represents your order reference or tracking number for this request.
>
>   Example: "123456789"
>
>   *Required*: true

**card** *{object}*

> Required: true
>
> Represents the credit card JSON object. The object has the attributes:
>
> * **number:** *int*\
>   Represents a Luhm compliant credit card value.\
>   Example: "4242424242424242"\
>   *Required: true*
> * **expiration\_date:** *string* \
>   Represents the expiration date of the card.\
>   Example: "01/27" | "01/2027"\
>   *Required: true*
> * **security\_code**: string\
>   Security code value represents the expiration date of the card.\
>   Example: "123"
>
>   *Required*: true

**order\_info** *{object}*

> Required: true
>
> This object represents the order information details with the attributes:
>
> * **amount\_details:** *{object}*\
>   *R*epresents the amount information details for the transaction, must contain these attributes:
>   * total\_amount: *integer*\
>     *Represents the total of the transaction.*\
>     Example: 1000\
>     *Required: true*
>   * *currency: string*\
>     *Represents the currency.* Use the three-character ISO Standard Currency Codes.\
>     Example: "COP"\
>     *Required: true*
> * ***installments**: integer*\
>   Represents the number of installments.\
>   Example: 1
>
>   *Required*: false

**bill\_to** *{object}*

> Required: true
>
> Represents the billing JSON object with the following the attributes:
>
> * **first\_name**: string
>
>   Example: “Steve”
>
>   *Required*: true.
> * **last\_name**: string
>
>   Example: “Jobs”
>
>   *Required*: true.
> * **country**: string
>
>   Example: “United States”
>
>   *Required*: true.
> * **address\_1**: string
>
>   Example: “412 W, Flower Village”
>
>   *Required*: true.
> * **address\_2**: string
>
>   Example: “apartment 54”
>
>   *Required*: true.
> * **city**: string
>
>   Example: “Miami”
>
>   *Required*: true.
> * **state**: string
>
>   Example: “Florida”
>
>   *Required*: true.
> * **phone\_number**: string
>
>   Example: “2561234567”
>
>   *Required*: true.
> * **email**: string
>
>   Example: “<steve.jobs@test.com>”
>
>   *Required*: true.
> * **postal\_code**: string
>
>   Example: “33125”
>
>   *Required*: true

**device\_info** *{object}*

> Required: false
>
> Represents the device information JSON object, provide information about the device like the following attribute:
>
> * **ip\_address**: string\
>   IP address of the device.
>
>   Example: “181.98.78.6”
>
>   Required: false