### Get Financial Identity

Source: https://www.postman.com/dark-moon-6575/mercadopago-public-api/collection/l4l1j4q/mercado-pago-checkout-transparente

Retrieves financial identity information for a given site ID and caller ID.

```APIDOC
## GET /v1/financial_identity

### Description
Retrieves financial identity details associated with a specific Mercado Pago site and caller. This endpoint might be used for compliance or internal tracking purposes.

### Method
GET

### Endpoint
/v1/financial_identity

### Parameters
#### Path Parameters
None

#### Query Parameters
- **caller.siteId** (string) - Required - The site ID for which to retrieve financial identity information (e.g., 'MLB').
- **caller.id** (string) - Required - The caller's unique identifier.

### Request Example
```
GET https://internal-api.mercadopago.com/v1/financial_identity?caller.siteId=MLB&caller.id=1448686200
```

### Response
#### Success Response (200)
- **financial_profile** (object) - Contains details about the financial profile.
  - **user_id** (string) - The user ID associated with the financial profile.
  - **type** (string) - The type of financial profile (e.g., 'individual', 'business').
  - **creation_date** (string) - The date the financial profile was created.

#### Response Example
```json
{
  "financial_profile": {
    "user_id": "1448686200",
    "type": "individual",
    "creation_date": "2023-01-15T10:00:00.000Z"
  }
}
```
```

--------------------------------

### Create Payment (credit card)

Source: https://www.postman.com/dark-moon-6575/mercadopago-public-api/collection/l4l1j4q/mercado-pago-checkout-transparente

Initiates a payment using credit card details or a previously generated credit card token.

```APIDOC
## POST /v1/payments

### Description
Creates a payment transaction using credit card information. This endpoint supports direct card details or a previously generated card token for enhanced security.

### Method
POST

### Endpoint
/v1/payments

### Parameters
#### Path Parameters
None

#### Query Parameters
None

#### Request Body
- **transaction_amount** (number) - Required - The amount of the transaction.
- **token** (string) - Optional - The token generated for the credit card. If not provided, `card_number` and other card details must be supplied.
- **card_number** (string) - Required if `token` is not provided - The full credit card number.
- **security_code** (string) - Required if `token` is not provided - The CVV or security code of the card.
- **cardholder_name** (string) - Required if `token` is not provided - The name of the cardholder.
- **expiration_month** (integer) - Required if `token` is not provided - The expiration month of the card.
- **expiration_year** (integer) - Required if `token` is not provided - The expiration year of the card.
- **installments** (integer) - Optional - The number of installments for the payment.
- **payment_method_id** (string) - Required - The ID of the payment method (e.g., 'credit_card').
- **payer** (object) - Required - Information about the payer.
  - **email** (string) - Required - Payer's email address.
  - **identification** (object) - Required - Payer's identification details.
    - **type** (string) - Required - Type of identification (e.g., 'CPF', 'CNPJ').
    - **number** (string) - Required - Payer's identification number.

### Request Example
```json
{
  "transaction_amount": 100.50,
  "token": "3811122233334444",
  "installments": 1,
  "payment_method_id": "credit_card",
  "payer": {
    "email": "test_payer@email.com",
    "identification": {
      "type": "CPF",
      "number": "12345678901"
    }
  }
}
```

### Response
#### Success Response (201)
- **id** (string) - The unique identifier for the payment.
- **status** (string) - The status of the payment (e.g., 'approved', 'pending', 'rejected').
- **transaction_amount** (number) - The amount of the transaction.

#### Response Example
```json
{
  "id": "123456789",
  "status": "approved",
  "transaction_amount": 100.50
}
```
```

--------------------------------

### Create Payment (PIX)

Source: https://www.postman.com/dark-moon-6575/mercadopago-public-api/collection/l4l1j4q/mercado-pago-checkout-transparente

Initiates a payment using the PIX payment method.

```APIDOC
## POST /v1/payments

### Description
Creates a payment transaction using the PIX payment method. This endpoint is used for generating PIX payment codes or QR codes.

### Method
POST

### Endpoint
/v1/payments

### Parameters
#### Path Parameters
None

#### Query Parameters
None

#### Request Body
- **transaction_amount** (number) - Required - The amount of the transaction.
- **payment_method_id** (string) - Required - The ID of the payment method (must be 'pix').
- **payer** (object) - Required - Information about the payer.
  - **email** (string) - Required - Payer's email address.
  - **identification** (object) - Required - Payer's identification details.
    - **type** (string) - Required - Type of identification (e.g., 'CPF', 'CNPJ').
    - **number** (string) - Required - Payer's identification number.

### Request Example
```json
{
  "transaction_amount": 50.00,
  "payment_method_id": "pix",
  "payer": {
    "email": "test_payer@email.com",
    "identification": {
      "type": "CPF",
      "number": "11122233344"
    }
  }
}
```

### Response
#### Success Response (201)
- **id** (string) - The unique identifier for the payment.
- **status** (string) - The status of the payment (e.g., 'pending', 'approved').
- **transaction_amount** (number) - The amount of the transaction.
- **point_of_interaction** (object) - Contains details for interacting with PIX.
  - **type** (string) - Type of interaction (e.g., 'PIX_CODE', 'QR_CODE').
  - **transaction_id** (string) - The transaction ID specific to PIX.
  - **ticket_url** (string) - URL for the PIX code or QR code.

#### Response Example
```json
{
  "id": "987654321",
  "status": "pending",
  "transaction_amount": 50.00,
  "point_of_interaction": {
    "type": "QR_CODE",
    "transaction_id": "pix_txid_12345",
    "ticket_url": "https://www.mercadopago.com.br/developers/pix/qr/12345"
  }
}
```
```

--------------------------------

### Create Credit Card Token (Cards)

Source: https://www.postman.com/dark-moon-6575/mercadopago-public-api/collection/l4l1j4q/mercado-pago-checkout-transparente

Creates a token for a credit card, which can then be used to create payments.

```APIDOC
## POST /v1/cards/token

### Description
Creates a secure token representing credit card details. This token can be used in subsequent payment requests to avoid sending sensitive card information directly.

### Method
POST

### Endpoint
/v1/cards/token

### Parameters
#### Path Parameters
None

#### Query Parameters
None

#### Request Body
- **card_number** (string) - Required - The full credit card number.
- **security_code** (string) - Required - The CVV or security code of the card.
- **cardholder_name** (string) - Required - The name of the cardholder as it appears on the card.
- **expiration_month** (integer) - Required - The expiration month of the card (1-12).
- **expiration_year** (integer) - Required - The expiration year of the card (e.g., 2024).

### Request Example
```json
{
  "card_number": "1234567890123456",
  "security_code": "123",
  "cardholder_name": "TESTING NAME",
  "expiration_month": 12,
  "expiration_year": 2025
}
```

### Response
#### Success Response (201)
- **id** (string) - The unique identifier for the created token.
- **card_number** (string) - Masked card number.
- **card_type** (string) - Type of card (e.g., 'credit', 'debit').

#### Response Example
```json
{
  "id": "3811122233334444",
  "card_number": "**** **** **** 3456",
  "card_type": "credit"
}
```
```

--------------------------------

### Create Seller Credit Card Token

Source: https://www.postman.com/dark-moon-6575/mercadopago-public-api/collection/l4l1j4q/mercado-pago-checkout-transparente

Creates a token for a seller's credit card, potentially for refund or internal operations.

```APIDOC
## POST /v1/cards/seller_token

### Description
Creates a secure token representing a seller's credit card details. This is typically used for internal operations such as processing refunds or managing seller payouts.

### Method
POST

### Endpoint
/v1/cards/seller_token

### Parameters
#### Path Parameters
None

#### Query Parameters
None

#### Request Body
- **card_number** (string) - Required - The full credit card number.
- **security_code** (string) - Required - The CVV or security code of the card.
- **cardholder_name** (string) - Required - The name of the cardholder as it appears on the card.
- **expiration_month** (integer) - Required - The expiration month of the card (1-12).
- **expiration_year** (integer) - Required - The expiration year of the card (e.g., 2024).

### Request Example
```json
{
  "card_number": "9876543210987654",
  "security_code": "456",
  "cardholder_name": "SELLER NAME",
  "expiration_month": 10,
  "expiration_year": 2026
}
```

### Response
#### Success Response (201)
- **id** (string) - The unique identifier for the created seller token.
- **card_number** (string) - Masked card number.
- **card_type** (string) - Type of card (e.g., 'credit').

#### Response Example
```json
{
  "id": "3876543210987654",
  "card_number": "**** **** **** 7654",
  "card_type": "credit"
}
```
```

=== COMPLETE CONTENT === This response contains all available snippets from this library. No additional content exists. Do not make further requests.