Orders

Payments can include an order_id which is the ID of the payment given by the merchant in their system. Merchants can retrieve payments based in this ID.
The Order Object
The Order Object
Order Object Example
Property
Type
Description
order_id
String
ID given by the merchant in their system.
payment_id
String
The payment id at dLocal.
amount
Positive Float
Transaction amount (in the currency entered in the field “currency”).
currency
String
Three-letter ISO currency code, in uppercase.
created_date
Date (ISO_8601)
Payment’s creation date.
approved_date
Date (ISO_8601)
Payment’s approval date.
status
String
​Payment status.
status_code
String
The payment status code.
status_detail
String
Payment status detail.
{
    "order_id": "LDMYZ5mtmsCa",
    "payment_id": "D-4-f77392b1-4ff0-477c-749ac9a237b5",
    "currency": "USD",
    "amount": 382.00,
    "created_date": "2018-07-12T15:20:02.000+0000",
    "approved_date": "2018-07-12T15:20:02.000+0000",
    "status": "AUTHORIZED",
    "status_code": "600",
    "status_detail": "The payment was authorized."
}
get
Retrieve an Order
https://api.dlocal.com/orders/{order_id}
Retrieve information about an existing order.
Request
Response
Path Parameters
order_id
required
string
ID given by the merchant in their system.
200: OK
{
  "payment_id": "D-4-f77392b1-4ff0-477c-749ac9a237b5",
  "order_id": "LDMYZ5mtmsCa",
  "amount": 382.00,
  "currency": "USD",
  "approved_date": "2018-07-11T19:55:56.348Z",
  "created_date": "2018-07-11T19:55:56.348Z",
  "status": "PENDING",
  "status_code": "100",
  "status_detail": "The payment is pending"
}
Example Request
$ curl \
    -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/orders/43343463432

Refunds

Currency Exchange

Last updated Tue Apr 23 2019 17:39:08 GMT+0000 (UTC)

Property	Type	Description
`order_id`	String	ID given by the merchant in their system.
`payment_id`	String	The payment id at dLocal.
`amount`	Positive Float	Transaction amount (in the currency entered in the field “currency”).
`currency`	String	Three-letter ISO currency code, in uppercase.
`created_date`	Date (ISO_8601)	Payment’s creation date.
`approved_date`	Date (ISO_8601)	Payment’s approval date.
`status`	String	Payment status.
`status_code`	String	The payment status code.
`status_detail`	String	Payment status detail.

Orders

The Order Object

getRetrieve an Order

Example Request

get
Retrieve an Order