PagoEfectivo

To use PagoEfectivo, you have to use follow their brand guide, listed below:

Brand guide

Logos, manuals, fonts

Country	Currency Accepted
Ecuador	USD
Peru	PEN, USD

⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀

Transactions Types	Meaning	Success return codes
RC	Successful generation of the PagoEfectivo payment slip.	000.000.000 000.100.112 (on staging)
PA	Successful payment of the PagoEfectivo payment slip. The payment of the PagoEfectivo slip is asynchronous and but usully takes up to 5 mintes after the shopper pays to be shown.	000.000.000

⠀⠀⠀⠀⠀⠀

Initial Request

//send POST to https://test.oppwa.com/v1/payments 
//Header -H "Authorization: Bearer OGE4Mjk0MTg0ZTczNjAxMj1234E2YTE1YjB8ZjJGRUtacXRCUA==" 
//API credentials entityId=8a8294174ae8145684aedfd75aa1d79 //entityId without authentication" 
//API credentials end 
amount=10.00 
paymentType=PA 
currency=COL 
merchantTransactionId=123456 
paymentBrand=PAGO_EFECTIVO 
customParameters[CUSTOM_due_date]=23032020 122343 //optional. DDMMAAAA HHMMSS. If not set, default is 3 days. 
customParameters[DOCTYPE]=DNI //optional. Can be one of the following: DNI (Documento nacional de identidad),PAR (Partida),PAS (Pasaporte),LMI (Libreta militar),NAN (another type) 
customParameters[DOCNUMBER]=21321321321354 //14 digits, numeric only. 
customer.phone=32523534532 //optional, phone number with country code. If sent, will be used to send SMS reminders by Pago_Efectivo. 
customer.email=[e-mail] // optional. 
customer.givenName=Peter //optional 
customer.surname=Prado //optional 
billing.postcode=232424//optional 
billing.country=PE -> Use country code = service render country. EG: PE 
shopperResultUrl=http://google.com //Although there is no re-direct back from PagoEfectivo slip to your shop, our API requires this parameter to be present 
testMode=EXTERNAL // Send this only on test. Delete this entry in live.

Successful Response

{ 
     "id":"8ac7a49f6855fc5801685805636585566", 
     "paymentType":"PA", 
     "paymentBrand":"PAGO_EFECTIVO", 
     "amount":"10.0", 
     "currency":"COL", 
     "presentationAmount":"10.0", 
     "presentationCurrency":"COL", 
     "descriptor":"9201.9521.3874", 
     "merchantTransactionId":"123456", 
     "result":{ 
        "code":"000.100.112", 
        "description":"Request successfully processed in 'Merchant in Connector Test Mode'", 
     }, 
     "resultDetails":{ 
        "ExtendedDescription":"Solicitud exitosa", 
        "AcquirerResponse":"100", 
        "ConnectorTxID1":"2315324" 
     }, 
     "billing":{
        "country":"EC" 
     }, 
     "authentication":{
        "entityId":"8a82941865d7e66c0165e76a6d861c1e" 
     }, 
     "redirect":{ 
        "url":"https://pre1a.payment.pagoefectivo.pe/3EA6FED6-0A17-463C-BE9D-763007D0E7AB.html", 
        "method":"GET", 
        "parameters":[] 
     }, 
     ,"timestamp":"2019-01-16 19:00:25+0000", 
     "ndc":"8a82941865d7e66c0165e76a6d861c1e_171ecf9107ae48a4a751bb85490c94fe", 
     "merchantAccountId":"8a82941865d7e66c0165e76c483f1c26" }

Re-directing the shopper

From the success response you will be able to extract the URL (under redirect → URL) to where you re-direct the shopper to in order to display the PagoEfectivo slip itself. Please note that the staging environment of the bank may show an error from time to time instead of the actual payment slip.

⠀⠀⠀⠀⠀⠀⠀⠀

Retrieve notifications when the Pago-Efectivo slip is paid

PagoEfectivo use webhooks to inform paid slips.

Webhooks with paymentType RC and result_code = '000.000.000' (or 000.100.112 on staging )are PagoEfectivo payment slips paid.

{
   "type":"PAYMENT",
   "payload":{
      "id":"8ac7a49f6855fc58016858092e4d6e26",
      "paymentType":"RC",
      "paymentBrand":"PAGO-EFECTIVO",
      "amount":"10.0",
      "currency":"COL",
      "presentationAmount":"10.0",
      "presentationCurrency":"COL",
      "descriptor":"9201.9521.3874",
      "merchantTransactionId":"123456",
      "result":{
         "code":"000.100.112",
         "description":"Request successfully processed in 'Merchant in Connector Test Mode'",
         "randomField983954327":"Please allow for new unexpected fields to be added"
      },
      "resultDetails":{
         "ExtendedDescription":"Transaction succeeded",
         "AcquirerResponse":"00",
         "AuthCode":"700000000001431901201900010005",
         "ConnectorTxID1":"8ac7a49f6855fc58016858092e4d6e26"
      },
      "billing":{
         "country":"EC"
      },
      "authentication":{
         "entityId":"8a82941865d7e66c0165e76a6d861c1e"
      },
      "redirect":{
         "url":"https://pre1a.payment.pagoefectivo.pe/3EA6FED6-0A17-463C-BE9D-763007D0E7AB.html",
         "method":"GET",
         "parameters":[
            {
               "name":"barcode",
               "value":"700000000001431901201900010005"
            }
         ]
      },
      "risk":{
         "score":""
      },
      "timestamp":"2019-01-16 19:00:25+0000",
      "ndc":"8a82941865d7e66c0165e76a6d861c1e_171ecf9107ae48a4a751bb85490c94fe",
      "merchantAccountId":"8a82941865d7e66c0165e76c483f1c26"
   }
}

Name	Description	Format	Example
amount	Amount of the payment request. The dot is used as a decimal separator.	N13 0- 9{1,10}.0 -9{2}	1.00
currency	Currency Code according to ISO 4217 specifications of the payment request’s amount	A3 a-zA-Z{3}	COL
paymentBrand	The brand specifies the method for the request	AN32 a-zA-Z0- 9_ {1,32}	PAGO_EFECTIVO
paymentType	The payment type for the request	A2	PA
entityId	The entity for the request. (e.g. channel)	AN32 a-zA-Z0- 9{32}	8a8294174ae82ada014 aedfd75aa1d79
merchantTransactionID	Merchant-provided reference number	AN255 \s\S{1,25 5}	1234
billing.country	Billing Country (has to be EC for PagoEfectivo to work.	A2	MX
customParametersCUSTOM_due_date	optional. If not set, default is 3 days. Date and time sent is in UTC.	DDMMAAAA HHMMSS	23032020 122343
customParametersDOCTYPE	Optional. Doc type used. Can be one of the following.DNI (Documento nacional de identidad) PAR (Partida) PAS (Pasaporte) LMI (Libreta militar) NAN (another type)	DNI (Documento nacional de identidad) PAR (Partida) PAS (Pasaporte) LMI (Libreta militar) NAN (another type)	DNI
customParametersDOCNUMBER	Optional. Number of the document.	AN14	D42342342334523
customer.phone	Optional, phone number with country code. If sent, will be used to send SMS reminders by PagoEfectivo.	N15	32523534532
customer.email	Optional. Customer email.	AN128 \s\S{6,128}	[e-mail]
customer.givenName	Optional. Customer first name.	AN \s\S	Peter
customer.surname	Optional. Customer surename	AN \s\S	Prado
billing.postcode	Customer postcode	AN30 A-Za-z0-9{1,30}	223224
shopperResultUrl	URL	AN2048 \s\S{6,2048}	http://www.google.com
id	Response id that is unique for each transaction	AN32	8ac7a49f6855fc5801685805636585566
resultDetails.ConnectorTxID1	Acquirer Reference. For PagoEfectivo this is the CIP number	AN255	123141
redirect.url	url for the payment slip	AN255	https://pagoefectivo.pe/234
redirect.method	Method you should use to redirect the shopper to the url	AN255	GET
redirect.parameters	parameters you should add to the URL when redirecting the shopper. may be null	AN255	payment=234
result.code	result code of the transaction. See ResultCodes	nnn.nnn.nnn	000.000.000
result.description	description of the result code	AN255	“Successfull transaction”
resultDetails.ExtendedDescription	acquirer description of their code	AN244	“Solicitud exitosa”
resultDetails.AcquirerResponse	acquirer result code	AN255	100
presentationAmount	amount	N13 0- 9{1,10}.0 -9{2}	10.00
presentationCurrency	currency	A3 a-zA-Z{3}	COL
descriptor	Descriptor of the transaction	AN255	PagoEfectivo 232.2939.29323
timestamp	Timestamp	YYYY-MM-DD HH:MM:SS+/-HHHH	2019-01-16 19:00:25+0000
ndc	Internal id for internal uses. Can be asked in case of an error	AN255	8a82941865d7e66c0165e76a6d861c1e_171ecf9107ae48a4a751bb85490c94fe
merchantAccountId	id of your merchant account	AN32	8a82941865d7e66c0165e76c483f1c26
testMode	testMode used on test. Should be EXTERNAL for PagoEfectivo	AN255	EXTERNAL

939B

Pagoefectivo.rar