The purpose of this guide is to explain how to create a transaction in Mexico step by step. Monnet has available Payment method in Mexico : Card Payment.
Currently, the Monnet Payin API has 1 version:
- For V3 a URL will be returned on the response, the merchant has to redirect the shopper to this URL
URL
API v3 (for JSON format with an url as response):
Certification: https://cert.monnetpayments.com/api-payin/v3/online-payments
Production: https://payin.api.monnetpayments.com/api-payin/v3/online-payments
V3: Create a Transaction
To create an online payment using Monnet Payments API, you must call the method online-payments as shown in the following example:
IMPORTANT REMINDER:All fields must be included on request no matter if they are required or optional. Also pay attention on payinCustomerName (fist name), payinCustomerLastName , payinCustomerEmail and payinCustomerPhone on each case. This four fields must NOT be sent with empty values on any case.
Creation - Online
Request
| Field | Description |
|---|---|
| payinMerchantID | Integer (Required) Merchant Identifier for the Payin API. |
| payinAmount | Decimal (Required) The amount of the transaction. Use 2 decimals. Remember that: Cents intervals go on a 50 cents basis. Suggested value is .00 as some cashiers will round amount up by default. |
| payinCurrency | String (Required, ISO-4217) The currency of the transaction Example MXN |
| payinMerchantOperationNumber | String (Required, max-lenght = 50) Reference number of the sale. This value is used to notify Merchants about a payment. |
| payinMethod | String (Required) Payment Method Identifier for the Payin API. EX: TCTD, TC, TD, BankTransfer,Cash, etc. Full List |
| payinVerification | String (Required) HASH SHA512 of: payinMerchantID+ payinMerchantOperationNumber+ payinAmount+ payinCurrency+ KeyMonnet |
| payinTransactionOKURL | String (Required) (max 250 chars) URL where the customer will be redirected from the online banking if payment was successful (Must be Https) |
| payinTransactionErrorURL | String (Required) (max 250 chars) URL where the customer will be redirected from the online banking if payment was wrong.(Must be Https) |
| payinExpirationTime | Integer (Required) Time in minutes to expire the token. Minimum Suggested: Online: 30 minutes Cash: 2 hours |
| payinLanguage | String (Required, ISO 639-1) Example: EN, ES, PT, DE, etc. |
| payinCustomerEmail | String (Required) Contains the customer's email |
| payinCustomerName | String (Required) Contains the customer's first name |
| payinCustomerLastName | String (Required) Contains the customer's last name |
| payinCustomerTypeDocument | String (Required) Contains the customer's type of document. payinCustomerTypeDocument |
| payinCustomerDocument | String (Required) Contains the customer's document number |
| payinCustomerPhone | String (Required) Contains the customer's mobile number |
| payinCustomerAddress | String (Required) Customer information |
| payinCustomerCity | String (Required) Customer information |
| payinCustomerRegion | String (Required) Customer information |
| payinCustomerCountry | String (Required) Customer information |
| payinCustomerZipCode | String (Required) Customer information |
| payinCustomerShippingName | String (Required) Customer information |
| payinCustomerShippingPhone | String (Required) Customer information |
| payinCustomerShippingAddress | String (Required) Customer information |
| payinCustomerShippingCity | String (Required) Customer information |
| payinCustomerShippingRegion | String (Required) Customer information |
| payinCustomerShippingCountry | String (Required) Customer information |
| payinCustomerShippingZipCode | String (Required) Customer information |
| payinRegularCustomer | String (Optional) Customer information |
| payinCustomerID | String (Optional) Customer information (PSPs must complete submerchant name mandatory) |
| payinDiscountCoupon | String (Requied) Customer information |
| payinFilterBy | String (Optional) Customer information |
| payinProductID | String (Required) Product information. Can not be empty, could send a default value i.e. "0" |
| payinProductDescription | String (Required) Product information. Can not be empty, could send a default value i.e. "0" |
| payinProductAmount | String (Required) Product information. Can not be empty, could send a default value i.e. "0" |
| payinDateTime | String (Required) Date of the transaction. Can not be empty, could send a default value i.e. current date |
| payinProductSku | String (Required) Product information. Can not be empty, could send a default value i.e. "0" |
| payinProductQuantity | String (Required) Product information. Can not be empty, could send a default value i.e. "0" |
| URLMonnet (For API v3) | String (Required) Value in cert environment: https://cert.monnetpayments.com/api-payin/v1/online-payments Value in prod environment: https://payin.api.monnetpayments.com/api-payin/v1/online-payments |
| typePost (For API v3) | String (Required) Value: json |
Sample request
Pay attention on fields name format, must be Camel Case as shown below:
data: {
"payinMerchantID": "00",
"payinAmount": "00.00",
"payinCurrency": "MXN",
"payinMerchantOperationNumber": "0000",
"payinMethod": "BankTransfer",
"payinVerification": "string",
"payinCustomerName": "string",
"payinCustomerLastName": "string",
"payinCustomerEmail": "[email protected]",
"payinCustomerPhone": "0000",
"payinCustomerTypeDocument": "CURP",
"payinCustomerDocument": "00000000000000",
"payinRegularCustomer": "string",
"payinCustomerID": "string",
"payinDiscountCoupon": "string",
"payinLanguage": "ES",
"payinExpirationTime": "000",
"payinDateTime": "YYYY-MM-DD",
"payinTransactionOKURL": "https://test.com",
"payinTransactionErrorURL": "https://test.com",
"payinFilterBy": "string",
"payinCustomerAddress": "string",
"payinCustomerCity": "string",
"payinCustomerRegion": "string",
"payinCustomerCountry": "Mexico",
"payinCustomerZipCode": "0000",
"payinCustomerShippingName": "string",
"payinCustomerShippingPhone": "0000",
"payinCustomerShippingAddress": "string",
"payinCustomerShippingCity": "string",
"payinCustomerShippingRegion": "string",
"payinCustomerShippingCountry": "Mexico",
"payinCustomerShippingZipCode": "0000",
"payinProductID": "0000",
"payinProductDescription": "string",
"payinProductAmount": "0000",
"payinProductSku": "string",
"payinProductQuantity": "0000",
"URLMonnet": "https://cert.monnetpayments.com/api-payin/v1/online-payments",
"typePost": "json"
}
Response
V3
For V3 a URL will be returned on the response, the merchant has to redirect the shopper to this URL
{
"url": "https://test.test",
"payinErrorCode": "0000",
"payinErrorMessage": "Successfull process",
"payinTrxOperation": "MONTRX207249992409275755"
}
Payment
When the transaction is created, a redirection to the payment gateway will be done.
payinMerchantOperationNumber
The payinMerchantOperationNumber returned in the response is the unique identifier for the transaction inside of Monnet's system. It is not needed to complete the payment, so it shouldn't be shown to the shopper because it may confuse him.
Important
Just because the shopper is redirected to the payinTransactionOKURL does not mean that the payment has been billed correctly. We recommend you to work with the notification system in the following section.
Test Credit Cards
For testing porpuses on Mexico we offer this set of credit cards (Visa and Mastercard only):
- Approved transaction with 3DS modal generation*: 4456528080389860
- Transaction rejected with 3DS modal generation*: 4456523340069956
- Approved transaction without 3DS modal generation: 4456540000000063
- Rejected transaction without 3DS modal generation: 4456541249811088
CVV: any
Expiration date: any future date
On modal generation use 1234 as OTP code (modal generation is use for fraud validation)
Other card brands will be rejected