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	Contiene información de la transacción	SI
setting	Objeto 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: Si el monto es 0.50 → Enviar 50 Si el monto es 10.00 → Enviar 1000	SI
currency	String	3	Código de moneda ISO-4217 (3 digitos numérico) Ejm: Soles → 604 Dólares → 840	SI
additionalFields	Diccionario	-	Contiene información adicional proporcionado por el comercio.	NO
billing	Objeto PAYMEAddressData	-	Información de facturación de la orden de compra.	SI
shipping	Objeto PAYMEAddressData	-	Información de envió de la orden de compra.	NO
customer	Objeto 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	-	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: Perú → PE	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: Perú → PE	SI
type	String	20	Tipo de documento de identidad: DNI CARNET_EXTRANJERIA PASAPORTE OTROS	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 BUILD_FORM(methods:[String]): Indica que métodos se mostraron al usuario en el SDK CHOOSE_PAYMENT_METHOD(method: String): Indica que método de pago seleccionó el usuario. RETURN_LIST_PAYMENT_METHODS: Indica que regresó al listado de métodos de pago. CANCEL_PAYMENT_METHOD(method: String): Indica que método de pago canceló el usuario. PRESS_PAY_BUTTON(method: String): Indica que método el usuario seleccionó pagar. CLOSE_PAYME: Indica que el usuario cerró el SDK	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	-	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: PENDIENTE INVALIDO AUTORIZADO DENEGADO	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	-	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	-	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: CARD YAPE QR CUOTEALO BANK_TRANSFER PAGO_EFECTIVO	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: REGISTRADO PENDIENTE INVALIDO AUTORIZADO DENEGADO	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