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 3 months ago