> ## Documentation Index
> Fetch the complete documentation index at: https://docs.pay-me.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Parámetros de Entrada y Salida de Pay-me SDK Android

# Cobros: Parámetros de Entrada y Salida de Pay-me SDK Android

A continuación, se detallan los parámetros de entrada y salida de Pay-me SDK.

## Parámetros de Entrada

### **Objeto PAYMEChargesRequest**

Abre tabla en pantalla completaAbrir

| **Parámetro** | **Tipo** | **Descripción** | **Obligatorio** |
| :- | :- | :- | :- |
| transaction | [Objeto PAYMETransactionData](https://docs.pay-me.com/es/sdk/v3.2/Android/parametros-de-entrada-y-salida-de-pay-me-sdk-andro#PAYMETransactionData) | Contiene información de la transacción | SI |
| setting | [Objeto PAYMESettingData](https://docs.pay-me.com/es/sdk/v3.2/Android/parametros-de-entrada-y-salida-de-pay-me-sdk-andro#PAYMESettingData) | Contiene información de ajuste del comportamiento del formulario de pago. | NO |

#### **Objeto PAYMETransactionData**

Abre tabla en pantalla completaAbrir

| **Parámetro** | **Tipo** | **Long.** | **Descripción** | **Obligatorio** |
| :- | :- | :- | :- | :- |
| operationNumber | String | 12 | Número de operación único en la  pasarela, el cual será utilizado para  realizar la transacción. (Cadena numérica entre 6 y 12 dígitos). | SI |
| amount | String | 11 | Monto en centavos cobrar por la pasarela de pago. La pasarela se encargar de aplicar el separador decimal. Ejemplo: <ul><li>Si el monto es 0.50 → Enviar 50</li><li>Si el monto es 10.00 → Enviar 1000</li></ul> | SI |
| currency | String | 3 | Código de moneda ISO-4217 (3 digitos numérico) Ejm: <ul><li>Soles → 604</li><li>Dólares → 840</li></ul> | SI |
| additionalFields | Diccionario | - | Contiene información adicional proporcionado por el comercio. | NO |
| billing | [Objeto PAYMEAddressData](https://docs.pay-me.com/es/sdk/v3.2/Android/parametros-de-entrada-y-salida-de-pay-me-sdk-andro#PAYMEAddressData) | - | Información de facturación de la orden de compra. | SI |
| shipping | [Objeto PAYMEAddressData](https://docs.pay-me.com/es/sdk/v3.2/Android/parametros-de-entrada-y-salida-de-pay-me-sdk-andro#PAYMEAddressData) | - | Información de envió de la orden de compra. | NO |
| customer | [Objeto PAYMEAddressData](https://docs.pay-me.com/es/sdk/v3.2/Android/parametros-de-entrada-y-salida-de-pay-me-sdk-andro#PAYMEAddressData) | - | Información del comprador. | NO |

**Objeto PAYMEAddressData**

Abre tabla en pantalla completaAbrir

| **Parámetro** | **Tipo** | **Long.** | **Descripción** | **Obligatorio** |
| :- | :- | :- | :- | :- |
| firstName | String | 30 | Nombres | SI |
| lastName | String | 50 | Apellidos | SI |
| email | String | 50 | Correo electrónico | SI |
| phone | String | 15 | Código del país y número de celular del titular de la tarjeta (51-958435685) | SI |
| identityDocument | [Objeto PAYMEIdentityDocument](https://docs.pay-me.com/es/sdk/v3.2/Android/parametros-de-entrada-y-salida-de-pay-me-sdk-andro#PAYMEIdentityDocument) | - | Objeto que contiene información de documento de identidad del comprador. Solo disponible para **CUSTOMER.** | NO |
| line1 | String | 50 | Dirección | SI |
| line2 | String | 50 | Dirección | NO |
| city | String | 50 | Ciudad/Provincia | SI |
| state | String | 15 | Estado/Departamento | SI |
| country | String | 2 | Código del País en letra. ISO-3166. Ejm: <ul><li>Perú → PE</li></ul> | SI |

###### **Objeto PAYMEIdentityDocument**

Abre tabla en pantalla completaAbrir

| **Parámetro** | **Tipo** | **Long.** | **Descripción** | **Obligatorio** |
| :- | :- | :- | :- | :- |
| country | String | 2 | Código del País en letra. ISO-3166. Ejm: <ul><li>Perú → PE</li></ul> | SI |
| type | String | 20 | Tipo de documento de identidad: <ul><li>DNI</li><li>CARNET\_EXTRANJERIA</li><li>PASAPORTE</li><li>OTROS</li></ul> | SI |
| identifier | String | 20 | Número de documento de identidad | SI |

#### **Objeto PAYMESettingData**

Abre tabla en pantalla completaAbrir

| **Parámetro** | **Tipo** | **Long.** | **Descripción** | **Obligatorio** |
| :- | :- | :- | :- | :- |
| locale | String | 5 | Localización del idioma que utilizará el formulario para mostrarse. | SI |
| **Valor - Descripción** | | | | |
| es\_PE Español Perú | | | | |
| walletUserId | String | 15 | Valor para identificar el wallet de un usuario. | NO |
| paymentMethods | Arrays\[String] | - | Listado de metodos de pagos que cargará el SDK, en caso de no enviarlo, se utilizará el listado de la configuracion del comercio | NO |
| **Valor - Descripción** | | | | |
| CARD - Tarjetas de Crédito / Débito | | | | |
| YAPE - Pago con yape | | | | |
| CUOTEALO - Pago con Cuotealo BCP | | | | |
| QR - Pago con Billeteras Móviles | | | | |
| BANK\_TRANSFER - Pago por Transferencia Bancaria | | | | |
| PAGO\_EFECTIVO - Pago por PagoEfectivo | | | | |
| `urlNotification` | String | 200 | URL donde se realizará la notificación luego de autorizar la transacción. Es opcional ya que se puede configurar por back | NO |

## **Parámetros de Salida**

### Objeto PaymeEvents

Abre tabla en pantalla completaAbrir

| **Parámetro** | **Tipo** | **Descripción** | **Req.** |
| :- | :- | :- | :- |
| PaymeEvents | Enum | Indicador de acción interna del SDK. Puede tener los siguientes valores <ul><li>`BUILD_FORM(methods:[String])`: Indica que métodos se mostraron al usuario en el SDK</li><li>`CHOOSE_PAYMENT_METHOD(method: String)`: Indica que método de pago seleccionó el usuario.</li><li>`RETURN_LIST_PAYMENT_METHODS`: Indica que regresó al listado de métodos de pago.</li><li>`CANCEL_PAYMENT_METHOD(method: String)`: Indica que método de pago canceló el usuario.</li><li>`PRESS_PAY_BUTTON(method: String)`: Indica que método el usuario seleccionó pagar.</li><li>`CLOSE_PAYME`: Indica que el usuario cerró el SDK</li></ul> | SI |

El objeto `PAYMEChargesResponse` está compuesto por los siguientes atributos:

### Objeto PAYMEChargesResponse

Abre tabla en pantalla completaAbrir

| **Parámetro** | **Tipo** | **Long.** | **Descripción** | **Obligatorio** |
| :- | :- | :- | :- | :- |
| success | Boolean | - | Tiene valor \*\*true \*\*si se realizó el proceso correctamente, \*\*false \*\*si ocurrió algún error durante el procesamiento del pago. | SI |
| resultCode | String | 2 | Código de resultado del procesamiento. | SI |
| resultMessage | String | 30 | Texto que describe el resultado del procesamiento. | SI |
| result | [Objeto PAYMETransactionResult](https://docs.pay-me.com/es/sdk/v3.2/Android/parametros-de-entrada-y-salida-de-pay-me-sdk-andro#PAYMETransactionResult) | - | Detalle del resultado de la transacción. | NO |

#### Objeto PAYMETransactionResult

Abre tabla en pantalla completaAbrir

| **Parámetro** | **Tipo** | **Long.** | **Descripción** | **Obligatorio** |
| :- | :- | :- | :- | :- |
| transactionId | String | 25 | Identificar único de la transacción generado por Pay-me | SI |
| operationNumber | String | 12 | Número de operación enviado por el Comercio | SI |
| state | String | - | Estado de la transacción: <ul><li>PENDIENTE</li><li>INVALIDO</li><li>AUTORIZADO</li><li>DENEGADO</li></ul> | SI |
| stateReason | String | 100 | Razón por la cual se quedó en aquel estado. | SI |
| amount | String | 11 | Monto de la autorización | SI |
| currency | String | 3 | Moneda usada en la autorización | SI |
| additionalFields | Diccionario | - | Contiene información adicional proporcionado por el comercio. | NO |
| paymentMethod | [Objeto PAYMEPaymentMethod](https://docs.pay-me.com/es/sdk/v3.2/Android/parametros-de-entrada-y-salida-de-pay-me-sdk-andro#PAYMEPaymentMethod) | - | Objeto del método de Pago | SI |
| expirationDate | String | - | Fecha en formato **UNIX** en la que la transacción será expirada. Disponible para QR y PAGO\_EFECTIVO | NO |
| processorResponse | String | 500 | JSON String que contiene respuesta de la procesadora. | NO |
| lifecycle | [Array PAYMETransactionLifecycle](https://docs.pay-me.com/es/sdk/v3.2/Android/parametros-de-entrada-y-salida-de-pay-me-sdk-andro#PAYMETransactionLifecycle) | - | Array de tiempos y estados por el cual paso la transacción | SI |

##### Objeto PAYMEPaymentMethod

Abre tabla en pantalla completaAbrir

| **Parámetro** | **Tipo** | **Long.** | **Descripción** | **Obligatorio** |
| :- | :- | :- | :- | :- |
| name | String | - | Método de pago usado para autorizar la transacción: <ul><li>CARD</li><li>YAPE</li><li>QR</li><li>CUOTEALO</li><li>BANK\_TRANSFER</li><li>PAGO\_EFECTIVO</li></ul> | SI |
| methodDetail | String | 500 | JSON String que contiene datos de la tarjeta usada para la autorización, estos datos están disponibles en métodos CARD - YAPE - QR. | NO |

##### Objeto PAYMETransactionLifecycle

Abre tabla en pantalla completaAbrir

| **Parámetro** | **Tipo** | **Long.** | **Descripción** | **Obligatorio** |
| :- | :- | :- | :- | :- |
| state | String | - | Estado de la transacción: <ul><li>REGISTRADO</li><li>PENDIENTE</li><li>INVALIDO</li><li>AUTORIZADO</li><li>DENEGADO</li></ul> | SI |
| utcTime | String | - | Fecha en formato UTC en la que la transacción cambio de estado. | SI |
| unixTime | String | - | Fecha en formato UNIX en la que la transacción cambio de estado. | SI |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.