Skip to main content
Skip table of contents

Parámetros de Entrada y Salida de Pay-me SDK iOS

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

Parámetros de Entrada

Objeto PAYMEChargesRequest

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

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.

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

-

Código de moneda ISO-4217.

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

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

SI

Objeto PAYMEIdentityDocument

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

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

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

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

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

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

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

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.