中文文档

The Card Object

For credit card payments you can use the card information only if your business is Full PCI DSS compliant. Otherwise, you need to collect the card information using Smart Fields. For recurring payments, make a payment with "save": true and use the card_id from the response for future payments.

❗️

Important

If you are making a payment with credit card information, you need to use the following endpoint instead:
https://api.dlocal.com/secure_payments

Card payments with a card_id or token should use the endpoint: https://api.dlocal.com/payments

PropertyTypeDescription
holder_nameStringCardholder's full name. Required if token or card_id not present.
expiration_monthIntegerTwo digit number representing the card's expiration month. Required if token or card_id are not present.
expiration_yearIntegerFour digit number representing the card's expiration year. Required if token or card_id are not present.
numberStringThe card number, as a string without any separators. Required if encrypted_data, token or card_id not present.
cvv StringCredit card verification value. Optional. Required for India.
encrypted_dataStringJWE encrypted params. ​
token StringTemporary credit card token securely created using Smart Fields. ​
cvv_tokenStringTemporary CVV token securely created using the CVV-only Smart Field. ​
card_idStringCredit card id returned by the Create a Card call. ​
installmentsStringNumber of installments. Default 1. ​
installments_idStringInstallments ID of an installments plan.
card_idStringCredit card id returned by the Create a Card call. ​
descriptorStringDynamic Descriptor. ​
captureBooleanWhether or not to immediately capture the charge. When false, the charge issues an authorization and will need to be captured later. Default TRUE. ​
saveBooleanWhether or not to save the card for future payments. The response will include a card_id. Learn more.​ ​

Example Object

Example with raw credit card information

{
        "holder_name": "Thiago Gabriel",
        "expiration_month": 10,
        "expiration_year": 2040,
        "number": "4111111111111111",
        "cvv": "123"
 }

Example with Smart Fields token

{
    "token":"CV-124c18a5-874d-4982-89d7-b9c256e647b5"
}

Example with card_id from Create a Card method

{    
    "card_id":"CV-hgv23jh4g-n23n-kj3k-bkhb3-kj3hj3gjh3k3"
}