Our Back to Back service enables seamless integration of your payment process by establishing a secure server-to-server connection to our services.
To take advantage of our server-to-server card payment service, it is imperative that your company is PCI certified. We ask that you share your AOC certification with your account manager before beginning the implementation process.
Currently, the Monnet Payin API has 1 version:
- For V3 a URL will be returned in the response after the merchant sends the transaction data to this URL.
URL
API v3 (for JSON format with an url as response):
Certification:https://sandbox.pci-proxy.com/v1/push/7efeb612e5dda6f1
Production: https://api.pci-proxy.com/v1/push/32dfee54fc151dd3
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. |
| payinCurrency | String (Required, ISO-4217) The currency of the transaction Example PEN |
| 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. 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 Max. 30 digit |
| payinCustomerLastName | String (Required) Contains the customer's last name. Max. 30 digit |
| 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 (8-9 digits) |
| payinCustomerAddress | String (Required) Customer information |
| payinCustomerCity | String (Required) Customer information |
| payinCustomerRegion | String (Required) Customer information (Default value is "Lima" unless different value is indicated by integration team) |
| 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/v3/online-payments Value in prod environment: https://payin.api.monnetpayments.com/api-payin/v3/online-payments |
| typePost (For API v3) | String (Required) Value: json |
| payinPan | String (Required) Enter the card number without separators (MAX. 19; MIN. 8) - This option is available exclusively for PCI certified merchants. |
| payinCvv | String (Required) Enter the card security code (MAX. 4; MIN. 3) - This option is only available for PCI certified merchants. |
| payinCardExpiration | String (Required) Year and month of card expiration (AAAA-MM) - This option is available exclusively for PCI certified merchants. |
Sample request
Pay attention on fields name format, must be Camel Case as shown below:
data: {
"payinMerchantID": "00",
"payinAmount": "00.00",
"payinCurrency": "PEN",
"payinMerchantOperationNumber": "0000",
"payinMethod": "TCTD",
"payinVerification": "string",
"payinCustomerName": "string",
"payinCustomerLastName": "string",
"payinCustomerEmail": "[email protected]",
"payinCustomerPhone": "0000",
"payinCustomerTypeDocument": "DNI",
"payinCustomerDocument": "00000000",
"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": "Peru",
"payinCustomerZipCode": "0000",
"payinCustomerShippingName": "string",
"payinCustomerShippingPhone": "0000",
"payinCustomerShippingAddress": "string",
"payinCustomerShippingCity": "string",
"payinCustomerShippingRegion": "string",
"payinCustomerShippingCountry": "Peru",
"payinCustomerShippingZipCode": "0000",
"payinProductID": "0000",
"payinProductDescription": "string",
"payinProductAmount": "0000",
"payinProductSku": "string",
"payinProductQuantity": "0000",
"URLMonnet": "https://cert.monnetpayments.com/api-payin/v3/online-payments",
"typePost": "json",
"payinPan": "4517721004856075",
"payinCvv": "123",
"payinCardExpiration": "2025-07"
}
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"
}
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.