Skip to content

Commit

Permalink
Merge pull request #2417 from mercadopago/feature/partners-guide-tran…
Browse files Browse the repository at this point in the history
…slation

Partners guide para hispanos - Tradução e localização
  • Loading branch information
hgaldino authored Aug 9, 2024
2 parents 05b37ed + 16d77ef commit a9a46af
Show file tree
Hide file tree
Showing 45 changed files with 2,508 additions and 301 deletions.
93 changes: 93 additions & 0 deletions guides/integration-guide-for-partners/bank-slip-en.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,93 @@
# Payment model - Bank Slip

By default, the due date for payments via bank slip is 3 days. However, it is possible to change this setting at the time of creation by using the `date_of_expiration` field in the payment creation request, defining a period between 1 and 30 days from the issue date of the bank slip.

To use this field, it is necessary to follow the ISO 8601 date format: yyyy-MM-dd'T'HH:mm:ssz.

Example:

```curl
"date_of_expiration": "2023-01-28T22:59:59.000-04:00"
```

```curl
curl --location --request POST 'https://api.mercadopago.com/v1/payments' \
--header 'x-platform-id: {{PLATFORM_ID provided by the Partners team}}' \
--header 'Authorization: Bearer {{ACCESS_TOKEN}}' \
--header 'Content-Type: application/json' \
--data-raw '{
"transaction_amount": 100,
"installments": 1,
"statement_descriptor": "Seller's store",
"capture": true,
"binary_mode": false,
"sponsor_id": {{ID of your Mercado Pago account related to your platform}},
"payment_method_id": "bolbradesco",
"date_of_expiration": "2023-02-28T22:59:59.000-04:00",
"external_reference": "Platform identifier",
"notification_url": "{{notification_url}}",
"description": "Seller's product description",
"payer": {
"first_name": "Name. Example: John",
"last_name": "Last name. Example: Jones",
"email": "Example: test_user_{{$timestamp}}@testuser.com",
"identification": {
"type": "Document type. Example: CPF",
"number": "Document number. Example: 19119119100"
},
"address": {
"zip_code": "Zip code. Example: 06233-200",
"street_name": "Street name. Example: Av. das Nações Unidas",
"street_number": "Number. Example: 3003",
"neighborhood": "Neighborhood. Example: Bonfim",
"city": "City. Example: Osasco",
"federal_unit": "Federal unit. Example: SP"
}
},
"additional_info": {
"referral_url": "Referral USP. Example: www.sellertest123.com",
"drop_shipping": true,
"delivery_promise": "2022-11-20",
"contrated_plan": "premium",
"items": [
{
"id": "1941",
"title": "Seller's product",
"description": "Description of the seller's product",
"picture_url": null,
"category_id": "electronics",
"quantity": 1,
"unit_price": 100.00
}
],
"payer": {
"first_name": "Name. Example: John",
"last_name": "Last name. Example: Jones",
"is_prime_user": "1",
"is_first_purchase_online": "1",
"last_purchase": "2019-10-25T19:30:00.000-03:00",
"phone": {
"area_code": "Area code. Example: 11",
"number": "Number. Example: 987654321"
},
"address": {
"zip_code": "Zip code. Example: 06233-200",
"street_name": "Street name. Example: Av. das Nações Unidas",
"street_number": "Number. Example: 3003"
},
"registration_date": "2013-08-06T09:25:04.000-03:00"
},
"shipments": {
"express_shipment": "0",
"pick_up_on_seller": "1",
"receiver_address": {
"zip_code": "Zip code. Example: 95630000",
"street_name": "Street name. Example: São Luiz",
"street_number": "Number. Example: 15",
"floor": "Floor (if it's an apartment). Example: Second",
"apartment": "Apartment number (if it's an apartment). Example: 93"
}
}
}
}'
```
93 changes: 93 additions & 0 deletions guides/integration-guide-for-partners/bank-slip.es.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,93 @@
# Modelo de pago - Boleto Bancario

Por defecto, el período de vencimiento para pagos mediante boleto bancario es de 3 días. Sin embargo, es posible cambiar la configuración en el momento de la creación, utilizando el campo `date_of_expiration` en la solicitud de creación del pago, definiendo un período entre 1 y 30 días a partir de la fecha de emisión del boleto.

Para utilizar este campo, es necesario seguir el formato de fecha ISO 8601: yyyy-MM-dd'T'HH:mm:ssz.

Ejemplo:

```curl
"date_of_expiration": "2023-01-28T22:59:59.000-04:00"
```

```curl
curl --location --request POST 'https://api.mercadopago.com/v1/payments' \
--header 'x-platform-id: {{PLATFORM_ID proporcionado por el equipo de Partners}}' \
--header 'Authorization: Bearer {{ACCESS_TOKEN}}' \
--header 'Content-Type: application/json' \
--data-raw '{
"transaction_amount": 100,
"installments": 1,
"statement_descriptor": "Tienda del vendedor",
"capture": true,
"binary_mode": false,
"sponsor_id": {{ID de su cuenta Mercado Pago referente a su plataforma}},
"payment_method_id": "bolbradesco",
"date_of_expiration": "2023-02-28T22:59:59.000-04:00",
"external_reference": "Identificador de la plataforma",
"notification_url": "{{notification_url}}",
"description": "Descripción del producto del vendedor",
"payer": {
"first_name": "Nombre. Ejemplo: John",
"last_name": "Apellido. Ejemplo: Jones",
"email": "Ejemplo: test_user_{{$timestamp}}@testuser.com",
"identification": {
"type": "Tipo de documento.",
"number": "Número del documento. Ejemplo: 19119119100"
},
"address": {
"zip_code": "Código postal. Ejemplo: 06233-200",
"street_name": "Nombre de la calle. Ejemplo: Av. das Nações Unidas",
"street_number": "Número de la calle. Ejemplo: 3003",
"neighborhood": "Barrio. Ejemplo: Bonfim",
"city": "Ciudad. Ejemplo: Osasco",
"federal_unit": "UF. Ejemplo: SP"
}
},
"additional_info": {
"referral_url": "URL de referencia. Ejemplo: www.sellertest123.com",
"drop_shipping": true,
"delivery_promise": "2022-11-20",
"contrated_plan": "premium",
"items": [
{
"id": "1941",
"title": "Producto del vendedor",
"description": "Descripción del producto del vendedor",
"picture_url": null,
"category_id": "Categoría. Ejemplo: electronics",
"quantity": 1,
"unit_price": 100.00
}
],
"payer": {
"first_name": "Nombre. Ejemplo: John",
"last_name": "Apellido. Ejemplo: Jones",
"is_prime_user": "1",
"is_first_purchase_online": "1",
"last_purchase": "2019-10-25T19:30:00.000-03:00",
"phone": {
"area_code": "Código de área. Ejemplo: 11",
"number": "Número del teléfono. Ejemplo: 987654321"
},
"address": {
"zip_code": "Código postal. Ejemplo: 06233-200",
"street_name": "Nombre de la calle. Ejemplo: Av. das Nações Unidas",
"street_number": "Número. Ejemplo: 3003"
},
"registration_date": "2013-08-06T09:25:04.000-03:00"
},
"shipments": {
"express_shipment": "0",
"pick_up_on_seller": "1",
"receiver_address": {
"zip_code": "Código postal. Ejemplo: 95630000",
"street_name": "Nombre de la calle. Ejemplo: São Luiz",
"street_number": "Número. Ejemplo: 15",
"floor": "Piso (si es un apartamento). Ejemplo: Segundo",
"apartment": "Número del apartamento (si es un apartamento). Ejemplo: 93"
}
}
}
}'
```
62 changes: 31 additions & 31 deletions guides/integration-guide-for-partners/bank-slip.pt.md
Original file line number Diff line number Diff line change
Expand Up @@ -18,74 +18,74 @@ curl --location --request POST 'https://api.mercadopago.com/v1/payments' \
--data-raw '{
"transaction_amount": 100,
"installments": 1,
"statement_descriptor": "LOJA DO SELLER",
"statement_descriptor": "Loja do vendedor",
"capture": true,
"binary_mode": false,
"sponsor_id": {{ADICIONE O ID DE SUA CONTA MERCADO PAGO REFERENTE A SUA PLATAFORMA}},
"sponsor_id": {{ID da sua conta Mercado Pago referente à sua plataforma}},
"payment_method_id": "bolbradesco",
"date_of_expiration": "2023-02-28T22:59:59.000-04:00",
"external_reference": "IDENTIFICADOR DA PLATAFORMA",
"external_reference": "Identificador da plataforma",
"notification_url": "{{notification_url}}",
"description": "Descrição Produto do seller",
"description": "Descrição do produto do vendedor",
"payer": {
"first_name": "Compra",
"last_name": "Silva",
"email": "test_user_{{$timestamp}}@testuser.com",
"first_name": "Nome. Exemplo: João",
"last_name": "Sobrenome. Exemplo: Silva",
"email": "Exemplo: test_user_{{$timestamp}}@testuser.com",
"identification": {
"type": "CPF",
"number": "19119119100"
"type": "Tipo de documento. Exemplo: CPF",
"number": "Número do documento. Exemplo: 19119119100"
},
"address": {
"zip_code": "06233-200",
"street_name": "Av. das Nações Unidas",
"street_number": "3003",
"neighborhood": "Bonfim",
"city": "Osasco",
"federal_unit": "SP"
"zip_code": "CEP. Exemplo: 06233-200",
"street_name": "Nome da rua. Exemplo: São Luiz",
"street_number": "Número. Exemplo: 15",
"neighborhood": "Bairro. Exemplo: Bonfim",
"city": "Cidade. Exemplo: Osasco",
"federal_unit": "UF. Exemplo: SP"
}
},
"additional_info": {
"referral_url": "www.sellertest123.com",
"referral_url": "URL de referência. Ejemplo: www.sellertest123.com",
"drop_shipping": true,
"delivery_promise": "2022-11-20",
"contrated_plan": "premium",
"items": [
{
"id": "1941",
"title": "Produto do seller",
"description": "Descrição Produto do seller",
"title": "Produto do vendedor",
"description": "Descrição do produto do vendedor",
"picture_url": null,
"category_id": "electronics",
"category_id": "Categoria. Exemplo: electronics",
"quantity": 1,
"unit_price": 100.00
}
],
"payer": {
"first_name": "Nome",
"last_name": "Sobrenome",
"first_name": "Nome. Exemplo: João",
"last_name": "Sobrenome. Exemplo: Silva",
"is_prime_user": "1",
"is_first_purchase_online": "1",
"last_purchase": "2019-10-25T19:30:00.000-03:00",
"phone": {
"area_code": "11",
"number": "987654321"
"area_code": "Código de área. Exemplo: 11",
"number": "Número do telefone. Exemplo: 987654321"
},
"address": {
"zip_code": "06233-200",
"street_name": "Av. das Nações Unidas",
"street_number": "3003"
"zip_code": "Código de área. Exemplo: 06233-200",
"street_name": "Nome da rua. Exemplo: Av. das Nações Unidas",
"street_number": "Número. Exemplo: 3003"
},
"registration_date": "2013-08-06T09:25:04.000-03:00"
},
"shipments": {
"express_shipment": "0",
"pick_up_on_seller": "1",
"receiver_address": {
"zip_code": "95630000",
"street_name": "são Luiz",
"street_number": "15",
"floor": "",
"apartment": ""
"zip_code": "Código de área. Exemplo: 95630000",
"street_name": "Nome da rua. Exemplo: São Luiz",
"street_number": "Número. Exemplo: 15",
"floor": "Andar (caso seja apartamento). Exemplo: Segundo",
"apartment": "Número do apartamento (caso seja apartamento). Exemplo: 93"
}
}
}
Expand Down
84 changes: 84 additions & 0 deletions guides/integration-guide-for-partners/credit-card-events.en.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,84 @@
# Payment model with credit card - Events/Tickets

```curl
curl --location --request POST 'https://api.mercadopago.com/v1/payments' \
--header 'x-platform-id: {{PLATFORM_ID provided by the Partners team}}' \
--header 'Authorization: Bearer {{ACCESS_TOKEN}}' \
--header 'Content-Type: application/json' \
--data-raw '{
"transaction_amount": 120.34,
"installments": 1,
"statement_descriptor": "Seller's store",
"capture": true,
"binary_mode": false,
"sponsor_id": {{ID of your Mercado Pago account related to your platform}},
"payment_method_id": "{{payment_method_id}}",
"token": "{{card_token_id}}",
"external_reference": "Platform identifier",
"notification_url": "{{notification_url}}",
"description": "Date (in the format dd/mm/yyyy) | Event name",
"payer": {
"first_name": "Name. Example: John",
"last_name": "Last name. Example: Jones",
"email": "Example: [email protected]",
"identification": {
"type": "Document type. Example: CPF",
"number": "Document number. Example: 19119119100"
},
"address": {
"zip_code": "Zip code. Example: 06233-200",
"street_name": "Street name. Example: Av. das Nações Unidas",
"street_number": "Number. Example: 3003",
"neighborhood": "Neighborhood. Example: Bonfim",
"city": "City. Example: Osasco",
"federal_unit": "Federal unit. Example: SP"
}
},
"additional_info": {
"referral_url": "Referral URL. Example: www.sellertest123.com",
"drop_shipping": false,
"delivery_promise": "2022-11-20",
"contrated_plan": "premium",
"items": [
{
"id": "1941",
"title": "Date (in the format dd/mm/yyyy) | Event name",
"description": "Date (in the format dd/mm/yyyy) | Event name",
"picture_url": null,
"category_id": "Category. Example: tickets",
"quantity": 1,
"unit_price": 120.34,
"event_date": "2019-12-25T19:30:00.000-03:00"
}
],
"payer": {
"first_name": "Name. Example: John",
"last_name": "Last name. Example: Jones",
"is_prime_user": "1",
"is_first_purchase_online": "1",
"last_purchase": "2020-10-25T19:30:00.000-03:00",
"phone": {
"area_code": "Area code. Example: 11",
"number": "Phone number. Example: 987654321"
},
"address": {
"zip_code": "Zip code. Example: 06233-200",
"street_name": "Street name. Example: Av. das Nações Unidas",
"street_number": "Number. Example: 3003"
},
"registration_date": "2013-08-06T09:25:04.000-03:00"
},
"shipments": {
"express_shipment": "0",
"pick_up_on_seller": "1",
"receiver_address": {
"zip_code": "Zip code. Example: 95630000",
"street_name": "Street name. Example: São Luiz",
"street_number": "Number. Example: 15",
"floor": "Floor (in case it is an apartment). Example: Second",
"apartment": "Apartment number (in case it is an apartment). Example: 93"
}
}
}
}'
```
Loading

0 comments on commit a9a46af

Please sign in to comment.