Authorizations

OUR SOLUTION COUNTRIES CUSTOMERS CONTACT US
Search…
Authorizations
This endpoint authorizes card’s transactions.
This endpoint must be implemented and exposed in your backend. A request will be sent to your server to approve or reject the transaction.
Authorization endpoints are required to respond in 2500 milliseconds or less. Otherwise, the transaction will be rejected.
Flow
The authorization object
Request Attributes
Authorization Object
Card Acceptor Object
Conversion Object
Property
Type
Description
card_id
String
Card ID provided when the card was created.
account_id
String
Account ID provided when the account was created.
transaction_id
String
Unique identifier for the transaction.
original_transaction_id
String
Unique identifier for the original transaction. It's uses when processing_code is  "20 - Cancel" or "06 - Capture"
entry_mode
String
The point of service entry mode. According ISO 8583 specification. 
Main possible values -the first 2 digits-: 
01 - Manual 
05 - Chip 
07 - Contactless 
10 - Credential on file 
80 - Fallback 
81 - Ecommerce 
90 - Magnetic stripe 
Others as defined by the network.
processing_code
String
Processing code for each transaction type. 
Main possible values -the first 2 digits-: 
00 - Purchase 
01 - Withdrawal 
02 - Debit adjustment 
05 - Authorization
06 - Capture
09 - Cashback 
20 - Cancel / Void
21 - Refund
30 - Balance Inquiry
Others as defined by the network.
created_date
String
Date at which the transaction was created.
created_time
String
Time at which the transaction was created.
amount_merchant
Number
Original transaction amount. -Max. 2 decimal numbers-
currency_merchant
String
Original currency at purchase. Three-letter ISO currency code.
amount_compensation
Number
Amount to be authorized in USD (for information purposes only). -Max. 2 decimal numbers-
currency_compensation
String
Three-letter ISO currency code.
amount_billing
Number
Final amount to be authorized in the user's currency. Includes taxes and fees if applicable. -Max. 2 decimal numbers-
currency_billing
String
Cardholder's local currency. Three-letter ISO currency code.
card_acceptor
Object
Seller information.
conversion
Object
Purchase amount in Euros or dollars.
Seller information.
Property
Type
Description
mid
String
Identifier for the seller.
mcc
String
The merchant category code for the seller's business. Merchant category code list. ​
category
String
A categorization of the seller's type of business.
name
String
Name of the seller.
country
String
Seller's country code.
state
String
State where the seller is located.
city
String
City where the seller is located.
street
String
Street where the seller is located.
zip_code
String
ZIP code where the seller is located.
Property
Type
Description
amount
Number
 Amount to be authorized.
currency
String
Destination currency code (ISO-4217)
exchange_rate
Decimal
The exchange rate of the given currency in relation to  dollar or Euro.
Response Attributes
Property
Type
Description
status
String
A status that indicates to dLocal whether to approve or reject the transaction. enum('APPROVED', 'REJECTED')
status_detail
String
Detail of the reason for not approving the transaction. Enum: ('APPROVED', 'REJECTED_BLACKLIST', 'REJECTED_HIGH_RISK', 'REJECTED_INVALID_AMOUNT', 'REJECTED_INSUFFICIENT_FUNDS', 'REJECTED_OTHER_REASON')
merchant_reference
String
Merchant reference to identify the authorization.
Status detail explanation 
Status Detail
Description
APPROVED
Transaction approved.
REJECTED_BLACKLIST
Blacklisted user account or merchant.
REJECTED_HIGH_RISK
High risk transaction.
REJECTED_INVALID_AMOUNT
Amount different from the original transaction.
REJECTED_INSUFFICIENT_FUNDS
Insufficient balance or limit.
REJECTED_OTHER_REASON
Rejected for other reason.
Example 
POST Request
Response
1
{
2
	"card_id" : "ISGC-1111-1111-1111",
3
	"account_id" : "ISGA-1111-1111-1111",  
4
	"transaction_id" : "ISGAT-dde39ccd-9883-4b84-9297-9a542dc5421d",
5
	"original_transaction_id" : "ISGAT-ccd38ccd-9883-4b84-9297-9a542dc5421e",
6
	"entry_mode" : "05",
7
	"processing_code" : "00",
8
	"created_date" : "2020-06-22",
9
	"created_time" : "11:05",
10
	"amount_merchant" : 220,
11
	"currency_merchant" : "ARS",
12
	"amount_compensation" 2,
13
	"currency_compensation" : "USD",
14
	"amount_billing": 220,
15
	"currency_billing" : "ARS",
16
	"card_acceptor" : {
17
		"mid" : "1234",
18
		"mcc" : "12",
19
		"category" : "15",
20
		"name" : "Walmart",
21
		"country" : "AR",
22
		"state" : "BA",
23
		"city" : "105",
24
		"street": "Calle Moreno Nro 134",
25
		"zip_code" : "1900"
26
	},
27
	"conversion":{
28
                   "amount": 2,
29
                   "currency": "USD",
30
                   "exchange_rate": 110
31
 	}
32
}
Copied!
1
{
2
  "status": "APPROVED",
3
  "status_detail": "APPROVED",
4
  "merchant_reference": "100002"
5
}
Copied!
Simulate Authorization
This endpoint allows simulate an authorization in Sandbox. You must have implemented the Webhook "Authorization events".
post
https://sandbox.dlocal.com/issuing/simulate/
authorizations
Simulate Authorization
​
The fail authorization object
Attributes
Property
Type
Description
card_id
String
Card ID provided when the card was created.
account_id
String
Account ID provided when the account was created.
transaction_id
String
Unique identifier for the transaction.
fail_type
String
Types of fails.  enum('TIME_OUT') 
Example
1
{
2
      	"card_id" : "ISGC-1111-1111-1111",
3
	"account_id" : "ISGA-1111-1111-1111",  
4
	"transaction_id" : "123456",
5
	"fail_type" : "TIME_OUT"
6
}
Copied!
​
Cancel Card
Authorization Controls
Last modified 16d ago
Copy link
Contents
Flow
The authorization object
Request Attributes
Response Attributes
Status detail explanation
Example
Simulate Authorization
post
Simulate Authorization
The fail authorization object
Attributes
Example