Cadastrando um novo comprador

Crie um novo comprador e guarde o identificador retornado para que você possa executar cobranças recorrentes, vincular cartões de crédito a carteira do comprador, utilizar conta de pagamento em nome do comprador, realizar criação de faturas e pagamentos do tipo boletos.

Para criar um comprador você deve ter pelo menos uma dentre as informação a seguir: nome, sobrenome, cpf/cnpj, email. Outras informações podem ser enviado na criação de um comprador, conforme documentação de referência.

Através das APIs de Buyer você pode criar, editar, excluir e atualizar os compradores, bem como permitir reembolsos, assinaturas, inserir detalhes do cartão de crédito para um comprador, editar detalhes e, claro, fazer transações.

Você pode buscar um comprador pelo CPF/CNPJ evitando ter que criar multiplos registros para o mesmo comprador no sistema. É possível visualizar também uma lista de todos os compradores do seu marketplace.

POST /v1/marketplaces/marketplace_id/buyers

{
  "first_name":"João", 
  "last_name": "Silva",
  "taxpayer_id":"{{insira_um_cpf_valido}}",
  "email":"[email protected]", 
  "address":{
    "line1":"Av Americas, 500", 
    "line2":"Citta América", 
    "neighborhood":"Barra da Tijuca", 
    "city":"Rio de Janeiro", 
    "state":"RJ", 
    "postal_code":"22845046", 
    "country_code":"BR" 
  },
  "metadata": 
        "twitter.id": "1234987650",
        "facebook.user_id": "0192837465",
        "my-own-customer-id": "12345"
    }
}
{
    "id": "2f27e83e5a654442b414fc2eaf6e5301",
    "status": "active",
    "resource": "buyer",
    "account_balance": "0.00",
    "current_balance": "0.00",
    "first_name": null,
    "last_name": null,
    "taxpayer_id": null,
    "description": null,
    "email": null,
    "phone_number": null,
    "facebook": null,
    "twitter": null,
    "address": {
        "line1": null,
        "line2": null,
        "line3": null,
        "neighborhood": null,
        "city": null,
        "state": null,
        "postal_code": null,
        "country_code": null
    },
    "delinquent": false,
    "payment_methods": null,
    "default_debit": null,
    "default_credit": null,
    "default_receipt_delivery_method": null,
    "uri": "\/v1\/marketplaces\/3249465a7753536b62545a6a684b0000\/buyers\/2f27e83e5a654442b414fc2eaf6e5301",
    "metadata": {},
    "created_at": "2020-03-30T00:41:10+00:00",
    "updated_at": "2020-03-30T00:41:10+00:00"
}
curl --request POST \
    --header "Content-Type: application/json" \
    --user zpk_test_EzCkzFFKibGQU6HFq7EYVuxI: \
    --url https://api.zoop.ws/v1/marketplaces/3249465a7753536b62545a6a684b0000/buyers \
    --data '{
  "first_name":"João",
  "last_name": "Silva",
  "taxpayer_id":"36787435010",
  "email":"[email protected]",
  "address":{
    "line1":"Av Americas, 500",
    "line2":"Citta América",
    "neighborhood":"Barra da Tijuca",
    "city":"Rio de Janeiro",
    "state":"RJ",
    "postal_code":"22845046",
    "country_code":"BR"
  },
  "metadata":
        "twitter.id": "1234987650",
        "facebook.user_id": "0192837465",
        "my-own-customer-id": "12345"
    }
}'

Associar um cartão a um comprador

Associe um cartão de crédito com o comprador existente, dando os identificadores de token e de clientes criados. O token do cartão será anexado ao comprador e estará pronto para ser cobrado:

Na associação de cartão a um comprador deve ser possível informar se este cartão é a opção default para cobrança na carteira do cliente ou não através do parâmetro is_default_debit.

{
   "token":"4bfe77cfddb843d6b9857c5cc4a38478",
   "customer":"2f27e83e5a654442b414fc2eaf6e5301"
}
{
    "id": "b2ca2b026f564c948f2c726c320b2171",
    "resource": "card",
    "description": null,
    "card_brand": "MasterCard",
    "first4_digits": "5201",
    "last4_digits": "4014",
    "expiration_month": "3",
    "expiration_year": "2018",
    "holder_name": "João Silva",
    "is_active": true,
    "is_valid": true,
    "is_verified": false,
    "customer": "2f27e83e5a654442b414fc2eaf6e5301",
    "fingerprint": "436c28bb86dcea3ef3cecdf1355c23887295afeb8248381b7c44d950e3d2053a",
    "address": null,
    "verification_checklist": {
        "postal_code_check": "unchecked",
        "security_code_check": "fail",
        "address_line1_check": "unchecked"
    },
    "metadata": {},
    "uri": "\/v1\/marketplaces\/3249465a7753536b62545a6a684b0000\/cards\/b2ca2b026f564c948f2c726c320b2171",
    "created_at": "2020-03-30T00:32:52+00:00",
    "updated_at": "2020-03-30T00:42:10+00:00"
}
curl --request POST \
    --header "Content-Type: application/json" \
    --user zpk_test_EzCkzFFKibGQU6HFq7EYVuxI: \
    --url https://api.zoop.ws/v1/marketplaces/3249465a7753536b62545a6a684b0000/cards \
    --data '{
        "token": "4bfe77cfddb843d6b9857c5cc4a38478",
        "customer": "2f27e83e5a654442b414fc2eaf6e5301"
    }'

Updated 8 days ago


Cadastrando um novo comprador


Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.