Ao usar o SDK da Yuno, nós cuidamos de todos os cenários específicos que qualquer método de pagamento possa ter. Depois que o cliente seleciona o método de pagamento e opta por pagar, se houver alguma informação extra necessária para processar o pagamento (além da que você compartilhou conosco na integração), exibiremos um formulário solicitando ao cliente essa informação específica necessária. Alguns exemplos desses cenários podem ser:
- Documento/telefone: Alguns métodos de pagamento alternativos exigem o documento do cliente ou o número de telefone, portanto, caso você não tenha essas informações em sua integração, nós as solicitaremos no formulário mencionado anteriormente para que você não precise fazer isso.
- PSE: esse método de pagamento exige que o cliente selecione o banco que usará para fazer o pagamento, portanto, oferecemos a ele uma lista de bancos para escolher.
SDK_CHECKOUTFluxo de trabalhoO
SDK_CHECKOUTpermite que você gerencie toda a experiência de pagamento, integrando-se diretamente às nossas APIs. Dependendo de suas necessidades, você pode escolher entre os seguintes fluxos de trabalho:
- Fluxo de trabalho direto: Adequado para cartões (disponível apenas para comerciantes em conformidade com o PCI).
- Fluxo de trabalho REDIRECT: Ideal para métodos de pagamento alternativos.
Para obter exemplos detalhados de pagamento, consulte as respectivas seções de cada categoria de método de pagamento.
Para o SDK_CHECKOUT fluxo de trabalho, todas as informações serão armazenadas no One-time token retornado pelo SDK da Yuno, para que você não precise alterar sua integração dependendo do método de pagamento. A estrutura básica do pagamento será a mesma para todos os métodos de pagamento, como no exemplo abaixo.
curl --location 'https://api-sandbox.y.uno/v1/payments' \
--header 'X-idempotency-key: <your-X-idempotency-key>' \
--header 'public-api-key: <your-public-api-key>' \
--header 'private-secret-key: <your-private-secret-key>' \
--header 'Content-Type: application/json' \
--data '{
"description": "SDK Checkout",
"account_id": "<account_id>",
"merchant_order_id": "123456",
"merchant_reference": "reference_001",
"country": "US",
"amount": {
"currency": "USD",
"value": 100
},
"checkout": {
"session": "<checkout_session>"
},
"customer_payer": {
"id": "<customer_id>"
},
"payment_method": {
"token": "<one_time_token>"
}
}'{
"id": "182ffc6e-9b3b-4e66-855b-94d2cfe07354",
"account_id": "493e9374-510a-4201-9e09-de669d75f256",
"description": "Test Card",
"country": "US",
"status": "SUCCEEDED",
"sub_status": "APPROVED",
"merchant_order_id": "0000022",
"created_at": "2023-07-20T20:42:24.144148Z",
"updated_at": "2023-07-20T20:42:28.479089Z",
"amount": {
"captured": 0.00,
"currency": "USD",
"refunded": 0.00,
"value": 100.00
},
"checkout": {
"session": "c1ded0b9-97ab-46f4-8cdb-ee3ce693f7f6",
"sdk_action_required": false
},
"payment_method": {
"vaulted_token": "f4ef4bd4-984e-43ca-b070-e00a9c66be6b",
"type": "CARD",
"vault_on_success": true,
"token": "f03b1dc7-a26b-48ca-93e3-3383fa3c17e8",
"payment_method_detail": {
"card": {
"verify": null,
"capture": true,
"installments": 1,
"first_installment_deferral": 0,
"installments_type": "",
"installment_amount": null,
"soft_descriptor": "",
"authorization_code": "385876",
"retrieval_reference_number": "",
"voucher": null,
"card_data": {
"holder_name": "Fannie Weissnat",
"iin": "41961111",
"lfd": "0010",
"number_length": 16,
"security_code_length": 3,
"brand": "VISA",
"issuer_name": "METABANK",
"issuer_code": "US_METABANK",
"category": "PREPAID",
"type": "PREPAID",
"three_d_secure": {
"setup_id": null,
"token": null,
"collect_url": null,
"setup_reference_id": null,
"developer_id": null,
"solution_id": null,
"code": null,
"version": null,
"electronic_commerce_indicator": null,
"cryptogram": null,
"transaction_id": null,
"acs_id": null,
"ds_id": null,
"pares_status": null
}
}
}
}
},
"customer_payer": {
"id": "d7cd334c-da1e-444a-8502-2f747fe67c52",
"merchant_customer_id": "1689885733",
"first_name": "John",
"last_name": "Smith",
"gender": "M",
"date_of_birth": null,
"email": "[email protected]",
"nationality": null,
"ip_address": null,
"device_fingerprint": null,
"browser_info": {
"user_agent": "",
"accept_header": "",
"accept_content": null,
"accept_browser": null,
"color_depth": "",
"screen_height": "",
"screen_width": "",
"javascript_enabled": null,
"java_enabled": null,
"browser_time_difference": null,
"language": ""
},
"document": {
"document_type": "PASSPORT",
"document_number": "38799992"
},
"phone": null,
"billing_address": null,
"shipping_address": null
},
"additional_data": null,
"taxes": null,
"transactions": {
"id": "10d8b481-f6d9-4fe3-98b5-a890d8a12ca9",
"type": "PURCHASE",
"status": "SUCCEEDED",
"category": "CARD",
"amount": 100.00,
"provider_id": "DLOCAL",
"payment_method": {
"vaulted_token": "f4ef4bd4-984e-43ca-b070-e00a9c66be6b",
"type": "CARD",
"vault_on_success": true,
"token": "f03b1dc7-a26b-48ca-93e3-3383fa3c17e8",
"detail": {
"card": {
"verify": null,
"capture": true,
"installments": 1,
"first_installment_deferral": 0,
"installments_type": "",
"installment_amount": null,
"soft_descriptor": "",
"authorization_code": "385876",
"retrieval_reference_number": "",
"voucher": null,
"card_data": {
"holder_name": "Fannie Weissnat",
"iin": "41961111",
"lfd": "0010",
"number_length": 16,
"security_code_length": 3,
"brand": "VISA",
"issuer_name": "METABANK",
"issuer_code": "US_METABANK",
"category": "PREPAID",
"type": "PREPAID",
"three_d_secure": {
"setup_id": null,
"token": null,
"collect_url": null,
"setup_reference_id": null,
"developer_id": null,
"solution_id": null,
"code": null,
"version": null,
"electronic_commerce_indicator": null,
"cryptogram": null,
"transaction_id": null,
"acs_id": null,
"ds_id": null,
"pares_status": null
}
}
}
}
},
"response_code": "SUCCEEDED",
"response_message": "Transaction successful",
"reason": null,
"description": "Test Card",
"merchant_reference": "referece_0001",
"provider_data": {
"id": "DLOCAL",
"transaction_id": "T-385928-006c26bc-db49-467c-ba60-6c4485cc6120",
"account_id": "",
"status": "PAID",
"sub_status": "",
"status_detail": "200",
"response_message": "The payment was paid.",
"raw_response": {
"value": "{\"id\":\"T-385928-006c26bc-db49-467c-ba60-6c4485cc6120\",\"amount\":100.00,\"currency\":\"ARS\",\"payment_method_id\":\"CARD\",\"payment_method_type\":\"CARD\",\"payment_method_flow\":\"DIRECT\",\"country\":\"AR\",\"card\":{\"holder_name\":\"Fannie Weissnat\",\"expiration_month\":3,\"expiration_year\":2024,\"brand\":\"VI\",\"last4\":\"0010\",\"installments\":1,\"installments_responsible\":\"customer\"},\"three_dsecure\":{},\"created_date\":\"2023-07-20T20:42:25.000+0000\",\"approved_date\":\"2023-07-20T20:42:28.000+0000\",\"status\":\"PAID\",\"status_detail\":\"The payment was paid.\",\"status_code\":\"200\",\"order_id\":\"10d8b481-f6d9-4fe3-98b5-a890d8a12ca9\",\"description\":\"Test Cards\",\"notification_url\":\"https://sandbox.y.uno/dlocal-webhook/v1/confirmations\",\"acquirer\":{\"authorization_code\":\"385876\"}}"
},
"third_party_transaction_id": ""
},
"three_d_secure_action_required": null,
"created_at": "2023-07-20T20:42:24.279905Z",
"updated_at": "2023-07-20T20:42:28.346109Z"
},
"split": [],
"callback_url": "https://google.com/?checkoutSession=c1ded0b9-97ab-46f4-8cdb-ee3ce693f7f6",
"workflow": "SDK_CHECKOUT",
"metadata": []
}