The purpose of this guide is to explain how to create a transaction in República Dominicana step by step. Monnet has available 1 Payment method in this country: Bank Transfer (Transferencia Bancaria).
IMPORTANT REMINDER:All fields must be included on request no matter if they are required or optional. Also pay attention on payinCustomerName (first name), payinCustomerLastName, payinCustomerEmail and payinCustomerPhone on each case. This four fields must NOT be sent with empty values on any case.
Bank Transfer
URL
API V3 (for JSON format to generate a ticket):
Certification: https://cert.monnetpayments.com/api-payin/v3/online-payments
Production: https://payin.api.monnetpayments.com/api-payin/v3/online-payments
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 DOP |
| payinMerchantOperationNumber | String (Required, max-length = 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 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 if payment was successful (Must be Https) |
| payinTransactionErrorURL | String (Required) (max 250 chars) URL where the customer will be redirected if payment was wrong (Must be Https) |
| payinExpirationTime | Integer (Required) Time in minutes to expire the token. Minimum Suggested: Bank Transfer: if the merchant does not define a value, the system applies a default of 120 minutes (2 hours). |
| payinLanguage | String (Required, ISO 639-1) Example: EN, ES, PT, DE, etc. |
| payinCustomerEmail | String (Required) Contains the customer's email. Max. 50 chars |
| 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. Valid values for República Dominicana: CIE — Cédula de Identidad y Electoral (11 digits) RNC — Registro Nacional del Contribuyente (9 digits) PP — Pasaporte (9 digits) 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 |
| payinDiscountCoupon | String (Optional) Customer information |
| payinFilterBy | String (Optional) Customer information |
| payinProductID | String (Required) Product information |
| payinProductDescription | String (Required) Product information |
| payinProductAmount | String (Required) Product information |
| payinDateTime | String (Required) Date of the transaction |
| payinProductSku | String (Required) Product information |
| payinProductQuantity | String (Required) Product information |
| 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 |
Sample request
Pay attention on fields name format, must be Camel Case as shown below:
data: {
"payinMerchantID": "00",
"payinAmount": "00.00",
"payinCurrency": "DOP",
"payinMerchantOperationNumber": "0000",
"payinMethod": "BankTransfer",
"payinVerification": "string",
"payinCustomerName": "string",
"payinCustomerLastName": "string",
"payinCustomerEmail": "[email protected]",
"payinCustomerPhone": "0000",
"payinCustomerTypeDocument": "CIE",
"payinCustomerDocument": "00112223344",
"payinRegularCustomer": "string",
"payinCustomerID": "string",
"payinDiscountCoupon": "string",
"payinLanguage": "ES",
"payinExpirationTime": "120",
"payinDateTime": "YYYY-MM-DD",
"payinTransactionOKURL": "https://test.com",
"payinTransactionErrorURL": "https://test.com",
"payinFilterBy": "string",
"payinCustomerAddress": "string",
"payinCustomerCity": "string",
"payinCustomerRegion": "string",
"payinCustomerCountry": "Republica Dominicana",
"payinCustomerZipCode": "0000",
"payinCustomerShippingName": "string",
"payinCustomerShippingPhone": "0000",
"payinCustomerShippingAddress": "string",
"payinCustomerShippingCity": "string",
"payinCustomerShippingRegion": "string",
"payinCustomerShippingCountry": "Republica Dominicana",
"payinCustomerShippingZipCode": "0000",
"payinProductID": "0000",
"payinProductDescription": "string",
"payinProductAmount": "0000",
"payinProductSku": "string",
"payinProductQuantity": "0000",
"URLMonnet": "https://cert.monnetpayments.com/api-payin/v3/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"
}
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.