Skip to content

Prepare existing transaction for client-side signing

Request

Prepares transaction data for client-side execution from existing transaction ID. Returns the data needed for the client to sign and submit the transaction.

Security
authJWT
Path
idstringrequired
curl -i -X GET \
  'https://docs.pers.ninja/_mock/swagger/transactions/{id}/prepare' \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>'

Responses

Transaction prepared successfully

Bodyapplication/json
transactionobject(TransactionDTO)required

Transaction details

transactionStatusstringrequired

Current status of the transaction

Enum:"created""processing""pending_signature""pending_submission""broadcasted""succeeded""failed""cancelled""expired"
signingDataobject or nullrequired

Prepared transaction data ready for signing (if applicable)

actionableobject or null(TransactionActionableDTO)required

Actionable details for the transaction, if applicable

walletSigningStatusstringrequired

Current status of the wallet signing process

signatureDataobject or null

Signature data (populated when transaction is signed but not submitted)

Response
{ "transaction": { "amount": "string", "id": "string", "tokenAddress": "string", "contractTokenId": "string", "tokenType": "string", "senderAddress": "string", "recipientAddress": "string", "transactionHash": "string", "type": "MINT", "triggerProcessType": "PURCHASE", "triggerProcessId": "string", "status": "created", "createdAt": "2019-08-24T14:15:22Z", "updatedAt": "2019-08-24T14:15:22Z", "tenantId": "string", "chainId": 0, "senderId": "string", "senderOwnerType": "user", "recipientId": "string", "recipientOwnerType": "user", "message": "string", "engagedBusinessId": "string", "authorizedSubmitterId": "string", "authorizedSubmitterType": "user", "userCountryCode": "string", "anonymizedIpAddress": "string", "metadataUri": "ipfs://QmXyz123.../metadata.json", "tokenMetadataIncrementalId": 0, "issuanceMode": "TENANT_DELEGATED_MINT", "included": { … } }, "transactionStatus": "created", "signingData": {}, "actionable": { "message": "string", "actionUrl": "string", "authToken": "string", "actionType": "string" }, "walletSigningStatus": "string", "signatureData": {} }