create_payin
Create a payin to accept funds from a payer, specifying amount, payer details, and return URL for redirect after payment.
Instructions
Create Payin — Create a new Payin resource - accepting funds from a Payer — [POST /payins]
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| payer | Yes | Information about the Payer. If providing name information, both `first_name` and `last_name` must be provided together. | |
| amount | Yes | Amount the Payer will be charged | |
| payment | No | ||
| reference | No | Merchant-defined reference identifier for this Payin | |
| return_url | Yes | URL where the Payer will be redirected after completing or canceling the Payin | |
| settlement | No | ||
| webhook_url | No | URL where Yugo will send webhook notifications for Payin status changes | |
| idempotency_key | No | Optional idempotency key for safe retries (max 36 chars, UUID recommended). Auto-generated if not provided. |