The purpose of this guide is to explain how to create a white label transaction in Peru step by step. Monnet has 3 payment methods available in Peru: Online (Internet Banking), Cash (Pay in cash) and Wallet (Digital Wallet).

Currently, the Monnet Payin API has 1 version:

📘
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.
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: BankTransfer,Cash, Wallet.
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) (max 250 chars)
payinTransactionErrorURL	String (Required) 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/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": "PEN",
  "payinMerchantOperationNumber": "0000",
  "payinMethod": "BankTransfer",
  "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/v1/online-payments",
  "typePost": "json"
}

Response

🚧
V3
For V3 a URL will be returned in the response for the merchant to redirect the buyer to this url , additional our system will provide the instructions generated by our system for the merchant to elaborate his own payment experience.

{
    "url": "https://test.test",
    "payinErrorCode": "0000",
    "payinErrorMessage": "Successfull process"
    "payinTrxOperation": "MONTRX4214729724051762681",
    "experienceVoucher": {
        "paymentCode": "13238534",
        "status": "PENDIENTE_PAGO",
        "expiration": "2024-05-17 18:58:17",
        "merchant": "Monnet WU",
        "amount": "1.00",
        "currencyCode": "PEN",
        "currencyISO": "S/",
        "operationNumber": "42147297",
        "voucherConfig":"{\"bankList\":[{\"bankCode\":\"BCP\",\"nroOrder\":1,\"hexColor\":\"#002D74\",\"paymentMethodInstructions\":[{\"method\":\"BankTransfer\",\"instructions\":[{\"order\":1,\"value\":\"Ingresa a tu Banca Web o aplicación móvil del BCP\"},{\"order\":2,\"value\":\"Selecciona la opción \\\"Pago de Servicios\\\" y busca la empresa/institución \<strong\>Monnet Pagos\</strong\>.\"},{\"order\":3,\"value\":\"Elige el tipo de moneda del servicio e ingresa tu código de pago \<strong\>13238534\</strong\>\"},{\"order\":4,\"value\":\"Valida el monto a pagar y confírmalo\"}]}]},{\"bankCode\":\"IBK\",\"nroOrder\":2,\"hexColor\":\"#00A24F\",\"paymentMethodInstructions\":[{\"method\":\"BankTransfer\",\"instructions\":[{\"order\":1,\"value\":\"Ingresa a tu Banca Web o aplicación móvil de Interbank\"},{\"order\":2,\"value\":\"Elige la opción \\\"Operaciones\\\", luego \\\"Servicios\\\" y finalmente \\\"Instituciones\\\". Busca la empresa \<strong\>Monnet Pagos\</strong\>.\"},{\"order\":3,\"value\":\"Elige el tipo de moneda del servicio e ingresa tu código de pago \<strong\>13238534\</strong\>\"},{\"order\":4,\"value\":\"Selecciona la deuda a pagar y confírmalo\"}]}]},{\"bankCode\":\"BBVA\",\"nroOrder\":3,\"hexColor\":\"#002D74\",\"paymentMethodInstructions\":[{\"method\":\"BankTransfer\",\"instructions\":[{\"order\":1,\"value\":\"Ingresa a tu Banca Web o aplicación móvil del BBVA\"},{\"order\":2,\"value\":\"Selecciona la opción \\\"Pagar Servicio\\\" y elige \\\"Agregar servicio a pagar\\\".\"},{\"order\":3,\"value\":\"Busca el servicio \<strong\>Monnet pagos Soles o Monnet pagos Dolares\</strong\>, ingresa tu código \<strong\>13238534\</strong\>\"},{\"order\":4,\"value\":\"Valida el monto a pagar y confírmalo\"}]}]},{\"bankCode\":\"YAPE\",\"nroOrder\":4,\"hexColor\":\"#680177\",\"paymentMethodInstructions\":[{\"method\":\"BankTransfer\",\"instructions\":[{\"order\":1,\"value\":\"Ingresa a tu app YAPE y selecciona la opción \<strong\>\\\"Yapear servicios\\\"\</strong\>\"},{\"order\":2,\"value\":\"Elige categoría \<strong\>\\\"Compras por Internet\\\"\</strong\> y selecciona \<strong\>\\\"Monnet Pagos\\\"\</strong\>\"},{\"order\":3,\"value\":\"Ingresa el código de pago \<strong\>13238534\</strong\>\"},{\"order\":4,\"value\":\"Selecciona el recibo y ¡listo!\"}]}]}],\"instruction_payment_methods\":[\"BankTransfer\"]}"
    }
}

Payment

🚧
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.

The following table describes the fields that our system will send to the merchant for creating the payment experience:

Field	Description	Example
paymentCode	Payment code	13238164
status	Payment status	PENDING_PAYMENT
expiration	Expiration date and time	2024-05-17 18:05:11
merchant	Merchant name	Monnet WU
amount	Payment amount	1.00
currencyCode	Currency code	PEN
currencyISO	ISO currency code	S/
operationNumber	Operation number	42144822
voucherConfig	Voucher configuration	See details below

VoucherConfig Details

Field	Description	Example
bankList / CashList/ WalletList	List of available banks,cash and wallets	See details below
instruction_payment_methods	Available payment methods	["BankTransfer"]

BankList Details

BankCode	Instruction 1	Instruction 2	Instruction 3	Instruction 4
BCP	Access your BCP web banking or mobile app	Select "Payment of Services" and search for the company/institution Monnet Pagos.	Choose the currency type and enter your payment code 13238164	Validate the amount to be paid and confirm
IBK	Access your Interbank web banking or mobile app	Select "Operations", then "Services", and finally "Institutions". Search for the company Monnet Pagos	Choose the currency type and enter your payment code 13238164	Select the debt to be paid and confirm
BBVA	Access your BBVA web banking or mobile app	Select "Pay Service" and choose "Add service to pay".	Search for the service Monnet pagos Soles or Monnet pagos Dólares, enter your code 13238164	Validate the amount to be paid and confirm
YAPE	Access your YAPE app and select the option "Yapear services"	Choose category "Internet Purchases" and select "Monnet Pagos"	Enter the payment code 13238164	Select the receipt and you're done!

CashList Details

BankCode	Instruction 1	Instruction 2	Instruction 3	Instruction 4
BCP	Go to a BCP agent and indicate you want to pay for the service Monnet Pagos	Indicate the service currency	Provide your payment code 13246792	Provide the total amount to be paid and complete the payment
IBK	Go to an Interbank agent and indicate you want to pay for the service Monnet Pagos	Indicate the service currency	Provide your payment code 13246792	Provide the total amount to be paid and complete the payment
BBVA	Go to a BBVA agent and indicate you want to pay for the service Monnet Pagos	Indicate the service currency.	Provide your payment code 13246792	Provide the total amount to be paid and complete the payment
KSNT	Go to a KASNET agent and indicate you want to pay for the service Monnet Pagos	Provide the Monnet Agent Code 220158	Provide your payment code 13246792	Provide the total amount to be paid and complete the payment
TAMBO	Go to a TAMBO store and indicate you want to pay for the service Monnet Pagos	Indicate the currency (Payment in soles or Payment in dollars)	Provide your payment code 13246792	Provide the total amount to be paid and complete the payment

WalletList Details

BankCode	Instruction 1	Instruction 2	Instruction 3	Instruction 4
YAPE	Access your YAPE app and select the option "Yapear services"	Choose category "Internet Purchases" and select "Monnet Pagos"	Enter the payment code 13238164	Select the receipt and you're done

White Label

📘
URL

V3: Create a Transaction

🚧

IMPORTANT REMINDER:

Creation - Online

Request

Sample request

Response

🚧
V3

Payment

🚧
payinMerchantOperationNumber

📘URL

V3: Create a Transaction

🚧

IMPORTANT REMINDER:

Creation - Online

Request

Sample request

Response

🚧V3

Payment

🚧payinMerchantOperationNumber

📘
URL

🚧
V3

🚧
payinMerchantOperationNumber