Pay-me SDK iOS input and output parameters
The following are the input and output parameters of the Pay-me SDK.
Input Parameters
PaymeRequest object
Parameter | Type | Required | Description |
setting | Yes | Contains the behavioral settings values of the payment form. | |
purchase | Yes | Contains purchase information | |
feature | No | Additional features during the transaction. |
PaymeSettingData object
Parameter | Type | Length | Required | Description |
locale | String | 5 | Yes | Localization of the language the form will be displayed in. |
Value - Description | ||||
es_PE Español Perú | ||||
brands | Array<String> | 4 | Yes | Contains the values of the marks that will be enabled for the payment form. |
Value - Description | ||||
VISA Visa | ||||
MSCD MasterCard | ||||
AMEX American Express | ||||
DINC Diners Club |
PaymePurchaseData object
Parameter | Type | Required | Description |
operation | Yes | Contains the data of the operation with which the transaction will be processed. | |
addrMatch | Boolean | No | Field indicating whether the shipping address will be the same as the billing address. |
billing | Yes | Purchase order billing data information. | |
shipping | No | Purchase order shipment data information. |
PaymeOperationData object
Parameter | Type | Length | Required | Description |
operationNumber | String | 6 | Yes | Unique transaction number in the gateway, which will be used to perform the transaction. |
operationDescription | String | 30 | Yes | Description of the product for which the transaction is made. |
amount | String | 11 | Yes | Amount to be charged by the payment gateway, it must be considered point as decimal separator and a maximum of two decimal digits (0.00). |
currency | - | Yes | Information of the currency in which the transaction will be made. |
PaymeCurrencyData object
Parameter | Type | Length | Required | Description |
code | String | 3 | Yes | Currency code ISO-4217. |
symbol | String | 5 | Yes | Currency symbol with which the amount will be displayed on the form has no effect on the transaction. The use of the symbols determined in ISO-4217 is recommended. |
PaymePersonData object
Parameter | Type | Length | Required | Description |
firstName | String | 30 | Yes | Name |
lastName | String | 50 | Yes | Surname |
String | 50 | Yes | E-mail address | |
addrLine1 | String | 50 | Yes | Address |
addrLine2 | String | 50 | No | Address |
countryCode | String | 2 | Yes | Country Code in letter. ISO-3166 |
countryNumber | String | 3 | Yes | Country code in number. ISO-3166 |
zip | String | 10 | Yes | Postal Code |
city | String | 50 | Yes | City/Province |
state | String | 15 | Yes | State/Department |
mobilePhone | String | 15 | Yes | Cardholder's country code and cell phone number (51-958435685) |
homePhone | String | 15 | No | Country code and cardholder's home phone number (51-958435685) |
workPhone | String | 15 | No | Cardholder's country code and work phone number (51-958435685) |
PaymeFeatureData object
Parameter | Type | Required | Description |
reserved | Dictionary | No | Contains the behavioral settings values for the reserved data coming from the trade. |
wallet | No | Contains the behavioral setting values for activating Wallet. | |
installments | No | Contains the behavioral setting values for activating Plans and Fees. | |
authentication | No | Contains the values of authentication behavior settings. |
PaymeWalletData object
Parameter | Type | Length | Required | Description |
enable | Boolean | - | No | Field to activate the use of wallet. Remember that the merchant must have enabled the wallet functionality in the service configurator. |
userID | String | 30 | No | Value to identify a user's wallet. It is mandatory when the enable parameter is true. |
PaymeInstallmentsData object
Parameter | Type | Required | Description |
enable | Boolean | No | Field to activate the use of plans and quotas. Remember that the merchant must have enabled the installments functionality in the configurator service. |
PaymeAuthenticationData Object
Parameter | Type | Length | Required | Description |
tdsChallengeInd | String | 2 | No | Indicates whether the challenge flow is required for the transaction. |
01 = No preferences | ||||
02 = No challenge required | ||||
03 = Challenge required: 3DSRequestor Preference | ||||
04 = Challenge required: Required | ||||
This parameter will only be considered if the merchant has 3DS authentication enabled. |
Output Parameters
PaymeInternalAction object
Parameter | Type | Description |
PaymeInternalAction | Enum | SDK internal action indicator. It can have the following values
|
PaymeResponse object
Parameter | Type | Length | Description |
success | Boolean | - | It is true if the process was successful, false if an error occurred during payment processing. |
resultCode | String | 2 | Processing result code. |
resultMessage | String | 30 | Text describing the result of processing. |
resultDetail | String | 100 | Additional details describing the result of the processing. |
reserved | Diccionario | - | Contains the behavioral settings values for the reserved data coming from the trade. |
payment | - | Result of the payment process as long as no error occurs in the transaction processing. |
PaymentProcessResponse object
Parameter | Type | Length | Description |
accepted | Boolean | - | It has value true when the payment has been processed correctly, false if it has been rejected for any reason at the time of the transaction. |
operationNumber | String | 6 | Transaction number corresponding to the transaction. |
operationDate | String | 25 | Transaction processing date. Example: 15/06/2023 11:30:49 +0000 ( |
authorizationCode | String | 10 | Transaction identifier. |
maskedPan | String | 16 | Masked card |
brand | String | 4 | Card brand |
installments | - | Information on plans and installments |
PaymentIntallmentsResponse Object
Parameter | Type | Length | Description |
type | String | 2 | |
number | String | 2 | |
amount | String | 11 | Value of the installment |
currencyCode | String | 2 | Currency |
firstExpirationDate | String | 10 | Date of first installment due date |