Stellar PHP SDK API Documentation

SEP08PostActionNextUrl extends SEP08PostActionResponse

Response indicating further action is required via browser interaction.

This response means the POST action request was processed but additional user action is still required. The wallet must open the provided next_url in a browser for the user to complete the necessary steps (e.g., KYC form, document upload, identity verification).

The next_url typically includes pre-filled information from the POST action request, reducing the amount of data the user needs to enter manually.

Workflow after receiving this response:

  1. Open next_url in system browser or in-app browser
  2. Wait for user to complete the action
  3. Resubmit the original transaction to the approval server

This indicates that programmatic submission of action fields was not sufficient and manual user interaction is required to complete the compliance workflow.

HTTP Status Code: 200

Tags
see
https://github.com/stellar/stellar-protocol/blob/v1.7.4/ecosystem/sep-0008.md#following-the-action-url

SEP-0008 v1.7.4

Table of Contents

Properties

$message  : string|null
$nextUrl  : string

Methods

__construct()  : mixed
Constructor.
fromJson()  : SEP08PostActionResponse
Factory method to construct an action response object from JSON data.

Properties

Methods

__construct()

Constructor.

public __construct(string $nextUrl[, string|null $message = null ]) : mixed
Parameters
$nextUrl : string

A URL where the user can complete the required actions with all the parameters included in the original POST pre-filled or already accepted.

$message : string|null = null

A human-readable string containing information regarding the further action required.

fromJson()

Factory method to construct an action response object from JSON data.

public static fromJson(array<string|int, mixed> $json) : SEP08PostActionResponse

Parses the JSON response after posting action fields and instantiates the appropriate concrete response class based on the 'result' field value.

Result Mapping:

  • "no_further_action_required" -> SEP08PostActionDone
  • "follow_next_url" -> SEP08PostActionNextUrl
Parameters
$json : array<string|int, mixed>

Decoded JSON response from action URL

Tags
throws
SEP08InvalidPostActionResponse

If result field is missing, unknown, or required fields for the given result are missing

Return values
SEP08PostActionResponse

Concrete subclass instance based on result field


        
On this page

Search results