Payment Methods Available

Cards

payment_method_idBrand IDNamepayment_method_typeDetailsAllowed FlowsLogo
CARDVIVisaCARDCredit Card ​DIRECT REDIRECTLogo
CARDMCMasterCardCARDCredit Card ​DIRECT REDIRECTLogo
CARDMDMasterCard Debit ​CARDDebit Card ​DIRECT REDIRECTLogo
CARDAEAmerican ExpressCARDCredit Card ​DIRECT REDIRECTLogo
CARDDCDiners ClubCARDCredit Card ​DIRECT REDIRECTLogo
CARDVDVisa Debit ​CARDDebit Card ​DIRECT REDIRECTLogo

ℹ️

To offer all the card options that may be available in your integration, send the payment_method_id as CARD.

Alternative Payment Method

payment_method_idNamepayment_method_typeDetailsAllowed FlowsLogo
EFPago EfectivoTICKETCash PaymentsDIRECT REDIRECTLogo
BCBCPBANK_TRANSFERBank Transfer OnlineDIRECT REDIRECTLogo
IBInterbankBANK_TRANSFERBank Transfer OnlineDIRECT REDIRECTLogo
BPBBVABANK_TRANSFERBank Transfer OnlineDIRECT REDIRECTLogo

Direct Alternative Payment Methods

Pago Efectivo

Example

curl -X POST \
    -H 'X-Date: 2018-02-20T15:44:42.310Z' \
    -H 'X-Login: sak223k2wdksdl2' \
    -H 'X-Trans-Key: fm12O7G9' \
    -H 'Content-Type: application/json' \
    -H 'X-Version: 2.1' \
    -H 'Authorization: V2-HMAC-SHA256, Signature: 1bd227f9d892a7f4581b998c21e353b1686a6bdad5940e7bb6aa596c96e0a6ec' \
    -d '{body}'
    https://api.dlocal.com/payments

{
"amount": 100,
"currency": "PEN",
"country": "PE",
"payment_method_id": "EF",
"payment_method_flow": "DIRECT",
"payer": {
      "name": "Pedro Gomez",
      "email": "[email protected]",
      "document": "27662162"
},
"order_id": "jhg4v34v534",
"notification_url": "http://merchant.com/notification/new"
}
{
    "id": "D-4-a291131e-f640-4579-b5de-95a709522272",
    "amount": 100,
    "currency": "PEN",
    "payment_method_id": "EF",
    "payment_method_type": "TICKET",
    "payment_method_flow": "DIRECT",
    "country": "PE",
    "ticket": {
        "type": "CUSTOM",
        "number": "28945684",
        "expiration_date": "2020-02-24T04:59:00.000+0000",
        "id": "EF-28945684",
        "company_name": "DEMERGE PERU SAC",
        "provider_name": "PagoEfectivo",
        "provider_logo": "https://pay.dlocal.com/views/2.0/images/payments/EF.png",
        "image_url": "https://pay.dlocal.com/gmf/payments/M-e622da70-5295-11ea-addf-83f8a04e38b5",
        "amount": 100,
        "currency": "PEN"
    },
    "created_date": "2020-02-18T21:30:35.000+0000",
    "status": "PENDING",
    "status_detail": "The payment is pending.",
    "status_code": "100",
    "order_id": "bbca8035-6d49-4283-abe0-6be78d29d8d6",
    "notification_url": "http://conductor.sandbox.internal/robot-server/rest/generic/notification/new"
}
819819

Provider ticket example.

User Interfase Tips UI

Provider's voucher

We strongly recommend using the ticket on the ticket.image_url. Peruvian users are very familiar with this ticket (example above) made by the provider itself, for every kind of purchase paid through Pago Efectivo. It includes:

  • Many payment options instructions
  • Capability of sending the payment code through SMS
  • Provider’s store locator

If you still need to design your own ticket and you are using this payment method through a DIRECT integration, follow the tips below in order to make it easier for your customers to complete payments, boosting your conversion rates.

ElementTip
Ticket NumberName it as "Código de Pago (CIP)"
Provider's NameShow the ticket.provider_name, as it is useful at the moment of paying through home banking.
Currency and AmountShould be relevant elements in the ticket. Users need to have that information very clear.
PE Currency SymbolS/
Expiration dateDisplay this element clear and visible enough. In Perú the date format is DD/MM/YYYY.
Payment instructionsAlthough most users are familiarized with PagoEefctivo, it is a good practice to help those who are not. In the image above there is an example of instructions, but if needed, our team will be happy to help you with more personalized instructions.
Save buttonIt help users to have their ticket always on their phone, making it needless to take notes or keep the browser opened.
Print buttonIt is useful for some users who need to have their tickets printed.