---
updatedAt: 2026-07-24T16:49:21.000Z
agentTools:
projectIndex: https://docs.dlocal.com/llms.txt
---
# Required datafields
Explore the required and recommended information for card and alternative payment methods transactions.
# Information
In this section, you will find the required and recommended data for all payments, including card transactions and alternative payment methods. For certain specific industries, additional data may be required.
Additionally, our API is equipped to receive any additional information you deem necessary for your fraud prevention strategy.
| Industry | Related industries |
| :--------------------------------------------------------------------------------------------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------- |
| [All industries](https://docs.dlocal.com/docs/requirements-per-industry#all-industries) | General mandatory and recommended data for all businesses. |
| [Marketplace, retail, and delivery](https://docs.dlocal.com/docs/requirements-per-industry#marketplace-retail-and-delivery) | Additional data required beyond the [general data](https://docs.dlocal.com/docs/requirements-per-industry#all-industries). |
| [Wallets and account fundings flow](https://docs.dlocal.com/docs/requirements-per-industry#wallets-and-account-fundings-flow) | Wallet or any industry involving account funding. Additional data required beyond the [general data](https://docs.dlocal.com/docs/requirements-per-industry#all-industries). |
| [Subscriptions](https://docs.dlocal.com/docs/requirements-per-industry#subscriptions) | Additional data required beyond the [general data](https://docs.dlocal.com/docs/requirements-per-industry#all-industries). |
| [Platforms](https://docs.dlocal.com/docs/requirements-per-industry#platforms) | Any merchant involving two or more submerchants/websites. Additional data required beyond the [general data](https://docs.dlocal.com/docs/requirements-per-industry#all-industries). |
## All industries
[block:parameters]
{
"data": {
"h-0": "Location",
"h-1": "Field",
"h-2": "General",
"0-0": "[payer](https://docs.dlocal.com/reference/the-payer-object)",
"0-1": "`name`",
"0-2": "Required",
"1-0": "[payer](https://docs.dlocal.com/reference/the-payer-object)",
"1-1": "`email`",
"1-2": "Required",
"2-0": "[payer](https://docs.dlocal.com/reference/the-payer-object)",
"2-1": "`phone`",
"2-2": "Recommended",
"3-0": "[payer](https://docs.dlocal.com/reference/the-payer-object)",
"3-1": "`document`",
"3-2": "Required",
"4-0": "[payer](https://docs.dlocal.com/reference/the-payer-object)",
"4-1": "`birth_date`",
"4-2": "Required",
"5-0": "[payer](https://docs.dlocal.com/reference/the-payer-object)",
"5-1": "`user_reference`",
"5-2": "Required",
"6-0": "[payer](https://docs.dlocal.com/reference/the-payer-object)",
"6-1": "`address`",
"6-2": "Recommended",
"7-0": "[payer](https://docs.dlocal.com/reference/the-payer-object)",
"7-1": "`ip`",
"7-2": "Required",
"8-0": "[payer](https://docs.dlocal.com/reference/the-payer-object)",
"8-1": "`device_id`",
"8-2": "Required",
"9-0": "[card](https://docs.dlocal.com/reference/risk-data-documentation#required-information)",
"9-1": "`holder_name`",
"9-2": "Required",
"10-0": "[additional_risk_data.payer](https://docs.dlocal.com/docs/risk-data-documentation#payer)",
"10-1": "`account_creation_date`",
"10-2": "Recommended",
"11-0": "[additional_risk_data.payer](https://docs.dlocal.com/docs/risk-data-documentation#payer)",
"11-1": "`is_positive`",
"11-2": "Recommended",
"12-0": "[additional_risk_data.basket](https://docs.dlocal.com/docs/risk-data-documentation#basket)",
"12-1": "`unit_price`",
"12-2": "Recommended",
"13-0": "[additional_risk_data.basket](https://docs.dlocal.com/docs/risk-data-documentation#basket)",
"13-1": "`category`",
"13-2": "Recommended",
"14-0": "[additional_risk_data.basket](https://docs.dlocal.com/docs/risk-data-documentation#basket)",
"14-1": "`item_reference`",
"14-2": "Recommended",
"15-0": "[additional_risk_data.basket](https://docs.dlocal.com/docs/risk-data-documentation#basket)",
"15-1": "`product_name`",
"15-2": "Recommended",
"16-0": "[additional_risk_data.basket](https://docs.dlocal.com/docs/risk-data-documentation#basket)",
"16-1": "`url`",
"16-2": "Recommended"
},
"cols": 3,
"rows": 17,
"align": [
"left",
"left",
"center"
]
}
[/block]
### Example payment
```json Example payment
{
"amount": 120.00,
"currency": "USD",
"country": "BR",
"payment_method_id": "CARD",
"payment_method_flow": "DIRECT",
"payer":{
"name": "Thiago Gabriel",
"email": "thiago@example.com",
"phone": "5512345678901",
"document": "53033315550",
"birth_date": "19980925",
"user_reference": "12345",
"address": {
"state": "Rio de Janeiro",
"city": "Volta Redonda",
"zip_code": "27275-595",
"street": "Servidao B-1",
"number": "1106"
},
"ip" : "2001:0db8:0000:0000:0000:ff00:0042:8329",
"device_id" : "2fg3d4gf234"
},
"card":{
"holder_name": "Thiago Gabriel",
"number": "4111111111111111",
"cvv": "123",
"expiration_month": 10,
"expiration_year": 2040
},
"order_id": "657434343",
"notification_url": "http://merchant.com/notifications",
"additional_risk_data": {
"payer" : {
"account_creation_date": "20210407",
"is_positive": true
},
"basket": [
{
"unit_price": 199.90,
"category": "Smartphone",
"item_reference": "SP-562138",
"product_name": "Pexel 25",
"quantity": 2,
"url": "http://merchant.com/product1234"
}
]
}
}
```
## Marketplace, retail and delivery
Additional data required beyond the [general data](https://docs.dlocal.com/docs/requirements-per-industry#all-industries) for marketplace, retail, and delivery industries.
[block:parameters]
{
"data": {
"h-0": "Location",
"h-1": "Field",
"h-2": "General",
"0-0": "[payer](https://docs.dlocal.com/reference/the-payer-object)",
"0-1": "`address`",
"0-2": "Required",
"1-0": "[shipping](https://docs.dlocal.com/reference/the-payer-object)",
"1-1": "`address`",
"1-2": "Required"
},
"cols": 3,
"rows": 2,
"align": [
"left",
"left",
"center"
]
}
[/block]
### Example payment
```json Example payment
{
"amount": 120.00,
"currency": "USD",
"country": "BR",
"payment_method_id": "CARD",
"payment_method_flow": "DIRECT",
"payer":{
"name": "Thiago Gabriel",
"email": "thiago@example.com",
"phone": "5512345678901",
"document": "53033315550",
"birth_date": "19980925",
"user_reference": "12345",
"address": {
"state": "Rio de Janeiro",
"city": "Volta Redonda",
"zip_code": "27275-595",
"street": "Servidao B-1",
"number": "1106"
},
"ip" : "2001:0db8:0000:0000:0000:ff00:0042:8329",
"device_id" : "2fg3d4gf234"
},
"card":{
"holder_name": "Thiago Gabriel",
"number": "4111111111111111",
"cvv": "123",
"expiration_month": 10,
"expiration_year": 2040
},
"order_id": "657434343",
"notification_url": "http://merchant.com/notifications",
"additional_risk_data": {
"payer" : {
"account_creation_date": "20210407",
"is_positive": true
},
"basket": [
{
"unit_price": 199.90,
"category": "Smartphone",
"item_reference": "SP-562138",
"product_name": "Pexel 25",
"quantity": 2,
"url": "http://merchant.com/product1234"
}
],
"shipping" : {
"address": {
"state": "Rio de Janeiro",
"city": "Volta",
"zip_code": "27273-5945",
"street": "Servidao B-21",
"number": "1209"
}
}
}
}
```
## Wallets and Account fundings flow
Wallet or any industry involving account funding. Additional data required beyond the [general data](https://docs.dlocal.com/docs/requirements-per-industry#all-industries).
[block:parameters]
{
"data": {
"h-0": "Location",
"h-1": "Field",
"h-2": "General",
"0-0": "[additional_risk_data.beneficiary](https://docs.dlocal.com/docs/risk-data-documentation#beneficiary)",
"0-1": "`email`",
"0-2": "Required",
"1-0": "[additional_risk_data.beneficiary](https://docs.dlocal.com/docs/risk-data-documentation#beneficiary)",
"1-1": "`phone`",
"1-2": "Required",
"2-0": "[additional_risk_data.beneficiary](https://docs.dlocal.com/docs/risk-data-documentation#beneficiary)",
"2-1": "`accountID`",
"2-2": "Required",
"3-0": "[additional_risk_data.beneficiary](https://docs.dlocal.com/docs/risk-data-documentation#beneficiary)",
"3-1": "`name`",
"3-2": "Required",
"4-0": "[additional_risk_data.beneficiary](https://docs.dlocal.com/docs/risk-data-documentation#beneficiary)",
"4-1": "`document`",
"4-2": "Required",
"5-0": "[additional_risk_data.beneficiary](https://docs.dlocal.com/docs/risk-data-documentation#beneficiary)",
"5-1": "`created_date`",
"5-2": "Required"
},
"cols": 3,
"rows": 6,
"align": [
"left",
"left",
"center"
]
}
[/block]
### Example payment
```json Example request
{
"amount": 120.00,
"currency": "USD",
"country": "BR",
"payment_method_id": "CARD",
"payment_method_flow": "DIRECT",
"payer":{
"name": "Thiago Gabriel",
"email": "thiago@example.com",
"phone": "5512345678901",
"document": "53033315550",
"birth_date": "19980925",
"user_reference": "12345",
"address": {
"state": "Rio de Janeiro",
"city": "Volta Redonda",
"zip_code": "27275-595",
"street": "Servidao B-1",
"number": "1106"
},
"ip" : "2001:0db8:0000:0000:0000:ff00:0042:8329",
"device_id" : "2fg3d4gf234"
},
"card":{
"holder_name": "Thiago Gabriel",
"number": "4111111111111111",
"cvv": "123",
"expiration_month": 10,
"expiration_year": 2040
},
"order_id": "657434343",
"notification_url": "http://merchant.com/notifications",
"additional_risk_data": {
"payer" : {
"account_creation_date": "20210407",
"is_positive": true
},
"basket": [
{
"unit_price": 199.90,
"category": "Coins",
"item_reference": "SP-562138",
"product_name": "Coins2",
"quantity": 2,
"url": "http://merchant.com/product1234"
}
],
"beneficiary":{
"email":"gabriel@example.com",
"phone":"55119846785",
"accountID":"384059hji",
"name":"gabriel thiago",
"document":"54678903",
"created_date":"20220704"
}
}
}
```
## Subscriptions
Additional data required beyond the [general data](https://docs.dlocal.com/docs/requirements-per-industry#all-industries).
| Location | Field | General |
| :------------------------------------------------------------------------------------- | :--------------- | :---------: |
| [additional\_risk\_data.basket.subscription](https://docs.dlocal.com/docs/risk-data-documentation#subscription) | `id` | Recommended |
| [additional\_risk\_data.basket.subscription](https://docs.dlocal.com/docs/risk-data-documentation#subscription) | `period` | Recommended |
| [additional\_risk\_data.basket.subscription](https://docs.dlocal.com/docs/risk-data-documentation#subscription) | `current_period` | Recommended |
| [additional\_risk\_data.basket.subscription](https://docs.dlocal.com/docs/risk-data-documentation#subscription) | `end_date` | Recommended |
### Example payment
```json Example payment
{
"amount": 120.00,
"currency": "USD",
"country": "BR",
"payment_method_id": "CARD",
"payment_method_flow": "DIRECT",
"payer":{
"name": "Thiago Gabriel",
"email": "thiago@example.com",
"phone": "5512345678901",
"document": "53033315550",
"birth_date": "19980925",
"user_reference": "12345",
"address": {
"state": "Rio de Janeiro",
"city": "Volta Redonda",
"zip_code": "27275-595",
"street": "Servidao B-1",
"number": "1106"
},
"ip" : "2001:0db8:0000:0000:0000:ff00:0042:8329",
"device_id" : "2fg3d4gf234"
},
"card":{
"holder_name": "Thiago Gabriel",
"number": "4111111111111111",
"cvv": "123",
"expiration_month": 10,
"expiration_year": 2040
},
"order_id": "657434343",
"notification_url": "http://merchant.com/notifications",
"additional_risk_data": {
"payer" : {
"account_creation_date": "20210407",
"is_positive": true
},
"basket": [
{
"unit_price": 199.90,
"category": "planA",
"item_reference": "AA-562138",
"product_name": "Plan basic",
"quantity": 1,
"url": "http://merchant.com/planA",
"subscription":{
"id":"adgte1256",
"period":"P1M",
"current_period":3,
"end_date":"20240801"
}
}
]
}
}
```
## Platforms
Any merchant involving two or more sub-merchants/websites. Additional data required beyond the [general data](https://docs.dlocal.com/docs/requirements-per-industry#all-industries).
[block:parameters]
{
"data": {
"h-0": "Location",
"h-1": "Field",
"h-2": "General",
"0-0": "[additional_risk_data.submerchant](https://docs.dlocal.com/docs/risk-data-documentation#submerchant)",
"0-1": "`merchant_reference`",
"0-2": "Required",
"1-0": "[additional_risk_data.submerchant](https://docs.dlocal.com/docs/risk-data-documentation#submerchant)",
"1-1": "`name`",
"1-2": "Recommended",
"2-0": "[additional_risk_data.submerchant](https://docs.dlocal.com/docs/risk-data-documentation#submerchant)",
"2-1": "`website`",
"2-2": "Required",
"3-0": "[additional_risk_data.submerchant](https://docs.dlocal.com/docs/risk-data-documentation#submerchant)",
"3-1": "`document`",
"3-2": "Required",
"4-0": "[additional_risk_data.submerchant](https://docs.dlocal.com/docs/risk-data-documentation#submerchant)",
"4-1": "`email`",
"4-2": "Required",
"5-0": "[additional_risk_data.submerchant](https://docs.dlocal.com/docs/risk-data-documentation#submerchant)",
"5-1": "`phone`",
"5-2": "Recommended",
"6-0": "[additional_risk_data.submerchant](https://docs.dlocal.com/docs/risk-data-documentation#submerchant)",
"6-1": "`onboarding_email`",
"6-2": "Recommended",
"7-0": "[additional_risk_data.submerchant](https://docs.dlocal.com/docs/risk-data-documentation#submerchant)",
"7-1": "`ship_from_address`",
"7-2": "Recommended"
},
"cols": 3,
"rows": 8,
"align": [
"left",
"left",
"center"
]
}
[/block]
### Example payment
```json Example payment
{
"amount": 120.00,
"currency": "USD",
"country": "BR",
"payment_method_id": "CARD",
"payment_method_flow": "DIRECT",
"payer":{
"name": "Thiago Gabriel",
"email": "thiago@example.com",
"phone": "5512345678901",
"document": "53033315550",
"birth_date": "19980925",
"user_reference": "12345",
"address": {
"state": "Rio de Janeiro",
"city": "Volta Redonda",
"zip_code": "27275-595",
"street": "Servidao B-1",
"number": "1106"
},
"ip" : "2001:0db8:0000:0000:0000:ff00:0042:8329",
"device_id" : "2fg3d4gf234"
},
"card":{
"holder_name": "Thiago Gabriel",
"number": "4111111111111111",
"cvv": "123",
"expiration_month": 10,
"expiration_year": 2040
},
"order_id": "657434343",
"notification_url": "http://merchant.com/notifications",
"additional_risk_data": {
"payer" : {
"account_creation_date": "20210407",
"is_positive": true
},
"basket": [
{
"unit_price": 199.90,
"category": "planA",
"item_reference": "AA-562138",
"product_name": "Plan basic",
"quantity": 1,
"url": "http://merchant.com/planA"
}
],
"submerchant":{
"merchant_reference":"45673",
"name":"SubmerchantAAB",
"website":"http://submerchantAAB.com",
"email":"submerchantAAB@example.com",
"phone":"5512345678903",
"onboarding_email":"submerchantAAB_onboarding@example.com",
"ship_from_address": {
"state": "Rio de Janeiro",
"city": "Volta Redonda 2",
"zip_code": "27275-545",
"street": "Servidao B-31",
"number": "11086"
}
}
}
}
```