def post_interactive_deposit(request: Request) -> Response:
"""
POST /transactions/deposit/webapp
This endpoint processes form submissions during the deposit interactive
flow. The following steps are taken during this process:
1. URL arguments are parsed and validated.
2. content_for_transaction() is called to retrieve the form used to
submit this request. This function is implemented by the anchor.
3. The form is used to validate the data submitted, and if the form
is a TransactionForm, the fee for the transaction is calculated.
4. after_form_validation() is called to allow the anchor to process
the data submitted. This function should change the application
state such that the next call to content_for_transaction() returns
the next form in the flow.
5. content_for_transaction() is called again to retrieve the next
form to be served to the user. If a form is returned, the
function redirects to GET /transaction/deposit/webapp. Otherwise,
The user's session is invalidated, the transaction status is
updated, and the function redirects to GET /more_info.
"""
args_or_error = interactive_args_validation(request)
if "error" in args_or_error:
return args_or_error["error"]
transaction = args_or_error["transaction"]
asset = args_or_error["asset"]
callback = args_or_error["callback"]
amount = args_or_error["amount"]
content = rdi.content_for_transaction(transaction)
if not (content and content.get("form")):
logger.error("Initial content_for_transaction() call returned None in "
f"POST request for transaction: {transaction.id}")
if transaction.status != transaction.STATUS.incomplete:
return render_error_response(
_("The anchor did not provide content, is the interactive flow already complete?"
),
status_code=422,
content_type="text/html",
)
return render_error_response(
_("The anchor did not provide form content, unable to serve page."
),
status_code=500,
content_type="text/html",
)
try:
form_class, form_args = content.get("form")
except TypeError:
logger.exception(
"content_for_transaction(): 'form' key value must be a tuple")
return render_error_response(
_("The anchor did not provide content, unable to serve page."),
status_code=500,
content_type="text/html",
)
is_transaction_form = issubclass(form_class, TransactionForm)
if is_transaction_form:
form = form_class(asset, request.POST, **form_args)
else:
form = form_class(request.POST, **form_args)
if form.is_valid():
if is_transaction_form:
fee_params = {
"operation": settings.OPERATION_DEPOSIT,
"asset_code": asset.code,
**form.cleaned_data,
}
transaction.amount_in = form.cleaned_data["amount"]
transaction.amount_fee = registered_fee_func(fee_params)
transaction.save()
rdi.after_form_validation(form, transaction)
content = rdi.content_for_transaction(transaction)
if content:
args = {"transaction_id": transaction.id, "asset_code": asset.code}
if amount:
args["amount"] = amount
if callback:
args["callback"] = callback
url = reverse("get_interactive_deposit")
return redirect(f"{url}?{urlencode(args)}")
else: # Last form has been submitted
logger.info(
f"Finished data collection and processing for transaction {transaction.id}"
)
invalidate_session(request)
transaction.status = Transaction.STATUS.pending_user_transfer_start
transaction.save()
url = reverse("more_info")
args = urlencode({"id": transaction.id, "callback": callback})
return redirect(f"{url}?{args}")
else:
content.update(form=form)
return Response(content, template_name="deposit/form.html", status=422)
def get_interactive_deposit(request: Request) -> Response:
"""
GET /transactions/deposit/webapp
This endpoint retrieves the next form to be served to the user in the
interactive flow. The following steps are taken during this process:
1. URL arguments are parsed and validated.
2. interactive_url() is called to determine whether or not the anchor
uses an external service for the interactive flow. If a URL is
returned, this function redirects to the URL. However, the session
cookie should still be included in the response so future calls to
GET /transactions/deposit/interactive/complete are authenticated.
3. content_for_transaction() is called to retrieve the next form to
render to the user. `amount` is prepopulated in the form if it was
passed as a parameter to this endpoint and the form is a subclass
of TransactionForm.
4. get and post URLs are constructed with the appropriate arguments
and passed to the response to be rendered to the user.
"""
args_or_error = interactive_args_validation(request)
if "error" in args_or_error:
return args_or_error["error"]
transaction = args_or_error["transaction"]
asset = args_or_error["asset"]
callback = args_or_error["callback"]
amount = args_or_error["amount"]
url = rdi.interactive_url(request, transaction, asset, amount, callback)
if url: # The anchor uses a standalone interactive flow
return redirect(url)
content = rdi.content_for_transaction(transaction)
if not content:
logger.error(
"The anchor did not provide content, unable to serve page.")
if transaction.status != transaction.STATUS.incomplete:
return render_error_response(
_("The anchor did not provide content, is the interactive flow already complete?"
),
status_code=422,
content_type="text/html",
)
return render_error_response(
_("The anchor did not provide content, unable to serve page."),
status_code=500,
content_type="text/html",
)
scripts = registered_scripts_func(content)
if content.get("form"):
try:
form_class, form_args = content.get("form")
except TypeError:
logger.exception(
"content_for_transaction(): 'form' key value must be a tuple")
return render_error_response(
_("The anchor did not provide content, unable to serve page."),
content_type="text/html",
)
is_transaction_form = issubclass(form_class, TransactionForm)
if is_transaction_form:
content["form"] = form_class(asset,
initial={"amount": amount},
test_value="103",
**form_args)
else:
content["form"] = form_class(**form_args)
url_args = {"transaction_id": transaction.id, "asset_code": asset.code}
if callback:
url_args["callback"] = callback
if amount:
url_args["amount"] = amount
post_url = f"{reverse('post_interactive_deposit')}?{urlencode(url_args)}"
get_url = f"{reverse('get_interactive_deposit')}?{urlencode(url_args)}"
content.update(post_url=post_url, get_url=get_url, scripts=scripts)
return Response(content, template_name="deposit/form.html")