Payment Methods Available

Cards

payment_method_idNamepayment_method_typeDetailsAllowed FlowsLogo
VIVisaCARDCredit Card ​DIRECT REDIRECTLogo
MCMasterCardCARDCredit Card ​DIRECT REDIRECTLogo
VDVisa DebitCARDCredit Card ​DIRECT REDIRECTLogo
MDMasterCard DebitCARDDebit Card ​DIRECT REDIRECTLogo
ELEloCARDCredit Card ​DIRECT REDIRECTLogo
ELEloCARDDebit Card ​DIRECT REDIRECT
MSMaestroCARDDebit Card ​DIRECT REDIRECTLogo
HIHipercardCARDCredit Card ​DIRECT REDIRECTLogo
MLCartao Mercado LivreCARDCredit Card ​DIRECT REDIRECTLogo
AEAmerican ExpressCARDCredit Card ​DIRECT REDIRECTLogo
JCJCBCARDCredit Card ​DIRECT REDIRECTLogo
AUAuraCARDCredit Card ​DIRECT REDIRECTLogo
DI DiscoverCARDCredit Card ​DIRECT REDIRECTLogo

Alternative Payment Method

payment_method_idNamepayment_method_typeDetailsAllowed FlowsLogo
BLBoletoTICKETCash PaymentDIRECT REDIRECTLogo
PQPIXTICKETPIXDIRECT REDIRECTLogo
IItauBANK_TRANSFERBank Transfer OnlineREDIRECTLogo
BBradescoBANK_TRANSFERBank Transfer OnlineREDIRECTLogo
BBBanco do BrasilBANK_TRANSFERBank Transfer OnlineREDIRECTLogo
CACaixa lBANK_TRANSFERBank Transfer OnlineREDIRECTLogo
SBSantanderBANK_TRANSFERBank Transfer OfflineREDIRECTLogo
MPMercado PagoBANK_TRANSFEReWalletDIRECT REDIRECTLogo
PYPicPayBANK_TRANSFEReWalletREDIRECTLogo

Direct Alternative Payment Methods

Boleto Bancário

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": "BRL",
    "country": "BR",
    "payment_method_id": "BL",
    "payment_method_flow": "DIRECT",
    "payer": {
        "name": "Pedro Gomes",
        "email": "[email protected]",
        "document": "42243309114"
    },
    "order_id": "jhg4v34v534",
    "notification_url": "http://conductor.sandbox.internal/robot-server/rest/generic/notification/new"
}
{
    "id": "D-4-1a64bdbd-faf5-473e-94b5-f96d36ef0d3f",
    "amount": 100,
    "currency": "BRL",
    "payment_method_id": "BL",
    "payment_method_type": "TICKET",
    "payment_method_flow": "DIRECT",
    "country": "BR",
    "ticket": {
        "type": "CUSTOM",
        "number": "10491775000000100389136517000100040010993600",
        "expiration_date": "2018-12-27T20:25:19.000+0000",
        "id": "14000000001099765",
        "barcode": "10491775000000100389136517000100040010993600",
        "company_name": "DLOCAL BRASIL LTDA",
        "provider_name": "caixa",
        "provider_logo": "http://static.dlocal.com/images/providers/caixa.png",
        "image_url": "http://pay.dlocal.com/gmf/payments/M-cee70da0-0542-11e9-b88f-39144191f926"
    },
    "created_date": "2018-12-21T17:06:49.545+0000",
    "status": "PENDING",
    "order_id": "jhg4v34v534",
    "notification_url": "http://conductor.sandbox.internal/robot-server/rest/generic/notification/new"
}
13001300

Example mobile UI built with the information in the example above.

👍

User Interface tips

  • Always offer an option to copy the ticket.number. It’s a long number and users that pay through their homebanking need to input it on their bank app/website.
  • Include the barcode. It is useful for users that pay through homebanking with barcode reader, and for the ones that pay at physical stores.
  • Barcode needs to have the Interleaved 2 of 5 (ITF) format in order to be recognized by all Boleto Bancario barcode readers.
  • Currency and amount should be relevant elements in the ticket. Users need to be aware of that at all times.
  • Make sure that the expiration date is clear and visible enough. In Brazil people use the dd/mm/yyyy format.
  • Add a link to the full boleto: ticket.image_url. Although it is not necessary to pay, some users prefer to have it and gives them a sense of security. Check out a full boleto example.

Did this page help you?