# Get payment by payment ID

Returns the details of a payment by its ID.

**GET** `/instore/v2/external/payments/{payment_id}`

## Request parameters

### Header

- `Authorization` (string, required)
  Bearer access token.

- `trace-id` (string, required)
  Traceability identifier.

### Path

- `payment_id` (string, required)
  Payment ID.

## Response parameters

- `payment_id` (string, optional)
  Unique identifier of the payment assigned by Mercado Pago.

- `order_id` (string, optional)
  Identifier of the order to which this payment belongs, as returned by the Resolve QR endpoint.

- `status` (string, optional)
  Current status of the payment in the Mercado Pago processing flow.
Possible enum values:

  - `APPROVED`
  Payment approved.

  - `REJECTED`
  Payment rejected.

  - `IN_PROCESS`
  Payment being processed.

  - `REFUNDED`
  Payment refunded.

  - `CHARGED_BACK`
  Chargeback applied.

- `status_code` (string, optional)
  Detailed status code providing additional context about the payment result, such as the specific approval or rejection reason.

- `authorization_code` (string, optional)
  Authorization code issued by the card network or acquirer to confirm the payment approval.

- `amount` (object, optional)
  Total amount charged to the card for this payment.

  - `amount.value` (number, optional)
  Numeric value of the payment amount.

  - `amount.currency` (string, optional)
  ISO 4217 currency code of the payment amount (e.g., ARS for Argentine peso).

- `authorized_amount` (object, optional)
  Amount effectively authorized by the card network, which may differ from the requested amount in partial authorization scenarios.

  - `authorized_amount.value` (number, optional)
  Numeric value of the authorized amount.

  - `authorized_amount.currency` (string, optional)
  ISO 4217 currency code of the authorized amount.

- `plan` (object, optional)
  Installment plan applied to this payment, as selected during the Process payment request.

  - `plan.id` (string, optional)
  Unique identifier of the installment plan applied to the payment.

  - `plan.type` (string, optional)
  Plan type, indicating the financing program (e.g., COMERCIO, ahora).

  - `plan.description` (string, optional)
  Human-readable description of the installment plan, including number of installments and any promotional conditions.

  - `plan.installments` (integer, optional)
  Number of installments in which the payment is split.

  - `plan.total_amount` (object, optional)
  Total amount of the payment including any financing charges.

  - `plan.total_amount.value` (number, optional)

  - `plan.total_amount.currency` (string, optional)

  - `plan.installment_amount` (object, optional)
  Amount charged per installment.

  - `plan.installment_amount.value` (number, optional)

  - `plan.installment_amount.currency` (string, optional)

- `card` (object, optional)
  Card data used to process the payment.

  - `card.original_bin` (string, optional)
  Original Bank Identification Number (BIN) of the card used, identifying the issuing bank and card type.

  - `card.original_last4` (string, optional)
  Last 4 digits of the original card number, used for display and reconciliation purposes.

  - `card.type` (string, optional)
  Card type used for the payment: CREDIT or DEBIT.

  - `card.brand_id` (string, optional)
  Internal identifier of the card brand (e.g., VISA, Mastercard) assigned by Mercado Pago.

  - `card.issuer_id` (string, optional)
  Internal identifier of the card-issuing bank assigned by Mercado Pago.

  - `card.holder` (object, optional)
  Information about the card holder.

  - `card.holder.name` (string, optional)
  Full name of the card holder as it appears on the card.

  - `card.holder.identification_type` (string, optional)
  Identification document type of the card holder (e.g., DNI for Argentina).

  - `card.holder.identification_number` (string, optional)
  Identification document number of the card holder.

- `wallet` (object, optional)
  Wallet data used to initiate the payment, as informed in the Process payment request.

  - `wallet.name` (string, optional)
  Commercial name of the wallet that initiated the payment.

  - `wallet.provider` (string, optional)
  Technical provider or platform that operates the wallet infrastructure.

  - `wallet.brand_wallet_id` (string, optional)
  Unique identifier assigned to the wallet brand by the payment network or provider.

  - `wallet.user` (object, optional)
  Data of the wallet user who initiated the payment.

  - `wallet.user.email` (string, optional)
  Email address of the wallet user.

  - `wallet.user.phone` (string, optional)
  Phone number of the wallet user.

  - `wallet.user.device_id` (string, optional)
  Unique identifier of the mobile device from which the payment was initiated.

  - `wallet.user.identification_type` (string, optional)
  Identification document type of the wallet user (e.g., DNI for Argentina).

  - `wallet.user.identification_number` (string, optional)
  Identification document number of the wallet user.

- `refunds` (array, optional)
  List of refunds associated with this payment. Each element contains the details of a refund operation.

- `created_at` (string, optional)
  ISO 8601 timestamp indicating when the payment was created.

- `updated_at` (string, optional)
  ISO 8601 timestamp indicating when the payment was last updated.

- `additional_info` (optional)
  Additional information associated with the payment. May be null.

## Errors

| Status | Error | Description |
| ------- | ------- | ----------- |
| 404 | — | Not Found |
| 500 | — | Internal Server Error |

## Request example

### cURL

```bash
curl -X GET \
  'https://api.mercadopago.com/instore/v2/external/payments/{payment_id}' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer <ACCESS_TOKEN>'
```

## Response example

```json
{
  "payment_id": "123",
  "order_id": "5582e8e3-a263-4c6b-bc12-a2d7b7f92860",
  "status": "APPROVED",
  "status_code": "APPROVED",
  "authorization_code": "301299",
  "amount": {
  "value": 100,
  "currency": "ARS"
  },
  "authorized_amount": {
  "value": 100,
  "currency": "ARS"
  },
  "plan": {
  "id": "MC10085214051",
  "type": "COMERCIO",
  "description": "description",
  "installments": 1,
  "total_amount": {
  "value": 300.5,
  "currency": "ARS"
  },
  "installment_amount": {
  "value": 300.5,
  "currency": "ARS"
  }
  },
  "card": {
  "original_bin": "450995",
  "original_last4": "3704",
  "type": "CREDIT",
  "brand_id": "118",
  "issuer_id": "310",
  "holder": {
  "name": "Test Test",
  "identification_type": "DNI",
  "identification_number": "23000000"
  }
  },
  "wallet": {
  "name": "galicia",
  "provider": "modo",
  "brand_wallet_id": "id_brand_123",
  "user": {
  "email": "test@example.com",
  "phone": "1141234567",
  "device_id": "ID_1234",
  "identification_type": "DNI",
  "identification_number": "33485274"
  }
  },
  "refunds": [],
  "created_at": "2024-01-17T11:37:47.000-04:00",
  "updated_at": "2024-01-17T11:37:47.000-04:00",
  "additional_info": null
}
```