Com o Checkout API do Mercado Pago você pode oferecer pagamentos com Botón Bancolombia, um meio de pagamento que permite realizar compras e pagamentos pela internet debitando os recursos diretamente das contas de poupança ou corrente do banco Bancolombia.

Para oferecer pagamentos com Botón Bancolombia, siga as etapas abaixo.

Para iniciar o processo de implementação do Botón Bancolombia, é necessário criar um pagamento. Você pode fazer isso por meio de uma chamada à nossa API ou com um de nossos SDKs.

Nesta etapa você deve utilizar seu Access TokenChave privada do aplicativo criado no Mercado Pago, usada no backend para as chamadas à API. Você pode acessar em Suas integrações > Detalhes do aplicativo > Produção > Credenciais de produção. Não a exponha do lado do cliente. de produção.

curl
Copiar
curl --location 'https://api.mercadopago.com/v1/payments' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer <YOUR_ACCESS_TOKEN>' \
--header 'X-Idempotency-Key: <SOME_UNIQUE_VALUE>' \
--data-raw '{
    "payer": {
        "email": "<PAYER_EMAIL>"
    },  
    "point_of_interaction": {
    "type": "CHECKOUT"
  },
  "payment_method_id": "boton_bancolombia",
  "transaction_amount": <TRANSACTION AMOUNT>,
  "description": "<DESCRIPTION>",
  "callback_url" : "<CALLBACK_URL>"
}'

A URL de retorno é o endereço para o qual o usuário é redirecionado após concluir o pagamento, seja aprovado, recusado ou pendente. Esta URL deve ser uma página que você controle, como um servidor com domínio (DNS).

Para configurá-la, preencha o valor CALLBACK_URL durante a criação do pagamento com uma URL de redirecionamento.

Após criar o pagamento, você deve executar a requisição.

Para concluir o pagamento, o comprador deverá ser redirecionado ao Bancolombia. Para isso, no frontend da sua integração você deve disponibilizar um botão de pagamento para o comprador. Ele deve redirecionar para a URL devolvida na resposta no parâmetro data.external_resource_url.

A seguir, compartilhamos um exemplo da resposta.

json
Copiar
{
    "id": 135212232104,
    ...
    "payment_method_id": "boton_bancolombia",
    "payment_type_id": "bank_transfer",
    "callback_url": "<CALLBACK_URL>"
    "payment_method": {
        "id": "boton_bancolombia",
        "type": "bank_transfer",
        "data": {
            "external_resource_url": "<REDIRECT_URL>"
        }
    },
    "status": "pending",
    ...
}

Para finalizar o processo de pagamento, você deve verificar o status do pagamento da compra. O pagamento é criado com status pendente ("status": "pending") e mantém esse status até que o pagador finalize o processo. Uma vez realizado o pagamento, o status passará a aprovado ("status": "approved").

Para isso, envie um GET à Obter pagamentoAPI substituindo o valor id pelo ID do pagamento a consultar.

curl
Copiar
curl -X GET \
    'https://api.mercadopago.com/v1/payments/{id}'\
    -H 'Content-Type: application/json' \
       -H 'Authorization: Bearer APP_USR-1*********685765-12*********1b4332e5c*********e077d7679*********664' \

Cada pagamento criado para Botón Bancolombia expira automaticamente em 12 minutos após ser gerado e seu status passa a recusado ("status": "rejected"). Se o comprador não acessar a página e realizar o pagamento dentro desse tempo, será necessário gerar um novo.