Facilitadores

Permite que os parceiros da ELO se identifiquem como facilitadores, associando os dados de seu usuário Merchant a um Payment Service Provider (PSP, ou facilitador). Tornando mais seguras e rastreáveis as transações efetuadas por um Merchant.

Feito para:  Facilitadores

Como funciona

Primeiros passos

  1. Leia Introdução ao GraphQL, com exemplos reais da nossa API.

  2. Crie um usuário no portal do desenvolvedor.

  3. Cadastre sua primeira aplicação.

  4. Utilize o dashboard para acessar suas configurações de acesso.

  5. Para explorar rapidamente as APIs aqui na página de documentação, use o console de GraphQL, na seção de referências. Nele, você pode ver as consultas de exemplo, executá-las e alterá-las.

Primeiros passos na plataforma de Desenvolvedores Elo

Jaydson GomesDesenvolvedor Evangelista

A associação de usuários Merchant ao PSP (Payment Service Provider, ou facilitador) torna possível a Elo e aos facilitadores identificar facilitadores e seus merchants associados.

Para acessar os recursos e informações disponibilizadas na Plataforma de APIs ELO é necessário antes que você cadastre e faça login com um usuário do tipo Merchant, após efetuar o login você receberá um access_token que deve ser utilizado nas chamadas para se identificar.

Os detalhes para cadastrar o usuário podem ser vistos na seção cadastro do portador.

Para realizar a associação é necessário utilizar a mutation associatePSPMerchant demonstrada abaixo: As requisições HTTPS devem possuir em seus cabeçalhos os dados necessários para o acesso ao serviço, neste caso o client_id e access_token:

mutation {
  associatePSPMerchant(
    input: {
      clientMutationId: "123456",
      legalId: "312312321321312",
      name: "Teste PSP",
      legalName: "Teste PSP",
      bankAccount: {
        type: SAVINGS,
        bankId: 104,
        branch: "1234",
        account: "1122334"
      },
      zip: "989832983293829",
      type: PHYSICAL,
      mcc: 5555,
      pvCode: "777",
      paymentTerm: {
        installments: 3,
        credit: 30,
        debit: 30
      }
    }
  )
  {
    clientMutationId,
    legalId
  }
}

Exemplo de Query PSP:

query {
  psp {
    id,
    name,
    legalName,
    description,
    legalIds{
      cnpj{
        number
      }
      cpf{
        number
      }
    }
    url
    merchants {
      edges {
        node {
          merchant {
            id
            name
          }
          mcc
          pvCode
          paymentTerm {
            installments
            credit
            debit
          }
          type
        }
      }
    }
  }
}

Para desassociar os dados de um PSP de um Merchant utilize a mutation a seguir fornecendo client_id e access_token:

mutation {
  dissociatePSPMerchant(
    input: {
      clientMutationId: "3333",
      pspId: 123,
      legalId: "3332221114"
    }
  )
  {
    clientMutationId,
    legalId
  }
}

Para buscar dados do PSP utilize a consulta a seguir fornecendo client_id e access_token:

query{
  psp {
    id,
    name,
    legalName,
    description,
    legalIds{
      cnpj{
        number
      }
      cpf{
        number
      }
    }
    url
    merchants{
      edges{
        node{
          merchant{
            id
            name
          }
          mcc
          pvCode
          paymentTerm{
            installments
            credit
            debit
          }
          type
        }
      }
    }
  }
}