Cuando se utiliza el SDK de Yuno, nos encargamos de cada escenario particular que cualquier método de pago podría tener. Una vez que el cliente selecciona el método de pago y elige pagar, si hay alguna información adicional necesaria para procesar el pago (además de la que compartiste con nosotros en la integración), mostraremos un formulario pidiendo al cliente esa información particular necesaria. Algunos ejemplos de estos escenarios podrían ser:
- Documento/teléfono: Algunos métodos alternativos de pago requieren el documento del cliente o el número de teléfono, así que en caso de que no tengas esa información en tu integración, te los pediremos en el formulario mencionado anteriormente para que no tengas que hacerlo.
- PSE: Este método de pago requiere que el cliente seleccione el banco que utilizará para realizar el pago, por lo que le ofrecemos una lista de bancos entre los que elegir.
SDK_CHECKOUTFlujo de trabajoEl objeto
SDK_CHECKOUTEl flujo de trabajo le permite gestionar toda la experiencia de pago integrándose directamente con nuestras API. Según sus necesidades, puede elegir entre los siguientes flujos de trabajo:
- Flujo de trabajo DIRECTO: Adecuado para tarjetas (disponible sólo para comerciantes que cumplan la normativa PCI).
- Flujo de trabajo REDIRECTO: Ideal para métodos de pago alternativos.
Para obtener ejemplos de pago detallados, consulte las secciones respectivas de cada categoría de método de pago.
Para el SDK_CHECKOUT flujo de trabajo, toda la información se almacenará en el One-time token devuelto por el SDK de Yuno, por lo que no tienes que cambiar tu integración según el método de pago. La estructura básica del pago será la misma para todos los métodos de pago, como en el siguiente ejemplo.
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": []
}