Create an authorization

Learn how to check if a card is valid and has enough funds available.

When authorizing a payment, you can receive approval that the card is valid and there are sufficient funds available from the card issuer.

For example, a car rental company may obtain an authorization when a customer picks up a car. The customer's card will not be charged, but the funds will be temporarily unavailable until the authorization expires or the funds are captured.

Example

To create an authorization, simply create a regular card payment with the parameter capture = FALSE within the card object.

$ curl -X POST \ -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 'Content-Type: application/json' \ -H 'Authorization: V2-HMAC-SHA256, Signature: 1bd227f9d892a7f4581b998c21e353b1686a6bdad5940e7bb6aa596c96e0a6ec' \ -d '{body}' https://api.dlocal.com/secure_payments { "amount": 120, "currency" : "USD", "country": "BR", "payment_method_id" : "CARD", "payment_method_flow" : "DIRECT", "payer":{ "name" : "Thiago Gabriel", "email" : "thiago@example.com", "document" : "53033315550" }, "card":{ "holder_name" : "Thiago Gabriel", "number" : "4111111111111111", "cvv" : "123", "expiration_month" : 10, "expiration_year" : 2040, "capture" : "false" }, "order_id": "657434343", "notification_url": "http://merchant.com/notifications" }
{ "id": "D-4-e2227981-8ec8-48fd-8e9a-19fedb08d73a", "amount": 120, "currency": "USD", "payment_method_id": "CARD", "payment_method_type": "CARD", "payment_method_flow": "DIRECT", "country": "BR", "card": { "holder_name": "Thiago Gabriel", "expiration_month": 10, "expiration_year": 2040, "brand": "VI", "last4": "1111" }, "created_date": "2019-02-06T21:04:43.000+0000", "approved_date": "2019-02-06T21:04:44.000+0000", "status": "AUTHORIZED", "status_detail": "The payment was authorized", "status_code": "600", "order_id": "657434343", "notification_url": "http://merchant.com/notifications" }

The id returned corresponds to the unique identifier of the Authorization (authorization_id).

📘

For a complete overview about the authorization process, we suggest you read the Authorization and Capture guide.

中文
Powered by Localize
English