Init Transaction

Init the transaction with a Transfer In token provided by Kushki which represents the customer's payment.

🚧 Early Release — Beta

This product is in early access. Parameters, response structures and behaviors may change without prior notice. Do not use this version in production without first coordinating with the Kushki integrations team.

🇵🇪 Peru — Yape flows (DEEPLINK / PUSH)

When the token was created with the processor object ({ "name": "Yape Processor", "flowType": "DEEPLINK" | "PUSH" }) there is no bank redirect: the response depends on the flow.

PUSH — the response carries ticketNumber and consentId. Yape sends a push notification to the phoneNumber sent in the token; tell the payer to approve it in the Yape app.

DEEPLINK — the response also carries deepLink. Redirect the payer to that URL exactly as received, without modifying its parameters (on a mobile browser it opens the Yape app).

The request body is the same as the traditional flow. The final result (approved, rejected, expired) arrives through your webhook; use transactionReference to correlate it.

Token ↔ processor compatibility

The token is bound to the processor it was generated for. If the token does not match the processor configured for your merchant (e.g. a token with processor on a merchant resolved to another processor, or a traditional token on a merchant configured with Yape), this endpoint returns 422 E046. Check Get Transfer In configuration and generate the token for the right processor.

curl --location 'https://api-uat.kushkipagos.com/transfer/v1/init' \ --header 'Private-Merchant-Id;' \ --header 'Content-Type: application/json' \ --data '{ "token": "string", "amount": { "subtotalIva": 0, "subtotalIva0": 0, "iva": 0, "extraTaxes": { "iac": 0, "tasaAeroportuaria": 0, "agenciaDeViaje": 0, "propina": 0, "tip": 0, "stateTax": 0, "municipalTax": 0, "reducedStateTax": 0 } }, "metadata": { "key0": "string", "key1": "string", "key2": "string" }, "fullResponse": "v2", "expirationDate": "2019-08-24T14:15:22.123Z", "webhooks": { "webhooks": [ { "events": [ "approvedTransaction", "declinedTransaction" ], "headers": [ { "label": "json", "value": "12" } ], "urls": [ "https://eof2hhkrta4ooo1.m.pipedream.net" ] } ] } }'

{ "redirectUrl": "https://api-uat.kushkipagos.com/transfer/v1/agent?token=a0be81f9856540e08ced6f5fd4f5732f&mid=20000000106212540000", "transactionReference": "aef8884f-cd4d-4b9b-9efa-ad582629e4f2" }

Request

Responses