Payment Methods

Object that identifies each payment method accepted by dLocal.

The Payment Method Object

Payment Method Object
Example Payment Method Object

Property

Type

Description

id

String

Payment method id

type

String

Type of method can be CARD BANK_TRANSFER DIRECT_DEBIT TICKET.

name

String

Payment type name

countries

String[]

Countries where the payment method is available.

logo

String

Payment method image url.

allowed_flows

String[]

Flows allowed for this payment, can be DIRECT orREDIRECT.

{
"id": "OX",
"type": "TICKET",
"name": "Oxxo",
"countries" : ["MX"],
"logo": "http://static.dlocal.com/payments-methods/OX/60x60",
"allowed_flows": ["DIRECT", "REDIRECT"]
}

get
Search Payment Methods

https://api.dlocal.com/payments-methods
This function returns a list of valid payment methods for the requested country.
Request
Response
Headers
X-Version
required
string
API Version
User-Agent
required
string
API Used to identify the application type, operating system, software vendor or software version of the requesting software user agent.
X-Date
required
string
ISO8601 Datetime with TimeZone.
X-Login
required
string
Merchant xLogin
X-Trans-Key
required
string
Merchant xTransKey
Authorization
required
string
<auth version>, Signature: <hmac(secretKey, "X-Login+X-Date Header+RequestBody")>
Query Parameters
country
required
string
Payment method country code.
200: OK
[
{
"id": "VI",
"type": "CARD",
"name": "Visa credit card",
"logo": "http://static.dlocal.com/payments-methods/VI/60x60.png",
"allowed_flows": ["DIRECT", "REDIRECT"]
},
{
"id": "AE",
"type": "CARD",
"name": "American Express",
"logo": "http://static.dlocal.com/payments-methods/AE/60x60.png",
"allowed_flows": ["DIRECT", "REDIRECT"]
},
{
"id": "GL",
"type": "BANK_TRANSFER",
"name": "Banco Galicia",
"logo": "http://static.dlocal.com/payments-methods/BT/60x60.png",
"allowed_flows": ["REDIRECT"]
},
{
"id": "RP",
"type": "TICKET",
"name": "Rapi pago",
"logo": "http://static.dlocal.com/payments-methods/RP/60x60.png",
"allowed_flows": ["REDIRECT"]
}
]

You can find all the country code available in the Country Reference page.

Example Request

curl -X GET \
-H 'X-Date: 2018-02-20T15:44:42.310Z' \
-H 'X-Login: sak223k2wdksdl2' \
-H 'X-Trans-Key: fm12O7G9' \
-H 'X-Version: 2.1' \
-H 'User-Agent: MerchantTest / 1.0 ' \
-H 'Authorization: V2-HMAC-SHA256, Signature: 1bd227f9d892a7f4581b998c21e353b1686a6bdad5940e7bb6aa596c96e0a6ec' \
https://api.dlocal.com/payments-methods?country=AR

Payment Method Codes

To make credit/debit card payments, you should use"CARD" as the payment_method_id. For other types of payments (eg: bank transfer), you should use the corresponding payment_method_idfound in the country-specific pages below.

Examples:

  • Payment with Visa credit card in Argentina, use payment_method_id = "CARD"

  • Payment with Rapi Pago in Argentina, use payment_method_id = "RP"

Payment Methods By Country