Lorsque vous utilisez le SDK de Yuno, nous prenons en charge tous les scénarios particuliers que peut avoir une méthode de paiement. Une fois que le client a sélectionné la méthode de paiement et choisi de payer, si des informations supplémentaires sont nécessaires pour traiter le paiement (en plus de celles que vous avez partagées avec nous dans l'intégration), nous afficherons un formulaire demandant au client de fournir ces informations particulières. Voici quelques exemples de ces scénarios :
- Document/téléphone: Certains modes de paiement alternatifs requièrent le document du client ou son numéro de téléphone. Si vous ne disposez pas de ces informations dans votre intégration, nous vous les demanderons dans le formulaire susmentionné afin que vous n'ayez pas à le faire.
- PSE: Ce mode de paiement exige que le client sélectionne la banque qu'il utilisera pour effectuer le paiement, et nous lui proposons donc une liste de banques parmi lesquelles il peut choisir.
SDK_CHECKOUTProcessusLe champ
SDK_CHECKOUTvous permet de gérer l'ensemble de l'expérience de paiement en vous intégrant directement à nos API. En fonction de vos besoins, vous pouvez choisir parmi les flux de travail suivants :
- Flux de travail DIRECT: Adapté aux cartes (disponible uniquement pour les commerçants conformes à la norme PCI).
- Flux de travail REDIRECT: Idéal pour les méthodes de paiement alternatives.
Pour des exemples de paiement détaillés, reportez-vous aux sections respectives de chaque catégorie de mode de paiement.
Pour les SDK_CHECKOUT Toutes les informations seront stockées dans le système de gestion de l'information. One-time token renvoyée par le SDK de Yuno, vous n'avez donc pas à modifier votre intégration en fonction de la méthode de paiement. La structure de base du paiement sera la même pour chaque méthode de paiement, comme dans l'exemple ci-dessous.
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": []
}