Repay Loan

Testing

Development

https://vf-solana-api.dev.alphaledger.com

PATCH

/api/v1/loans/repay

Creates Solana Transaction:If Requested

OperationId:repayLoan

Repays a loan. Use the itemsToRepay to specify the items from the borrower wallet to payoff the debts with and the itemsToRelease to specify what items to release from the loan back to the borrower wallet.

Defi Lending Protocols supported:

Loopscale

For LOOPSCALE loands: the account of the borrower needs to be passed as the lookup in the solanaTransactionConfig.feePayer. Because the feePayer cannot be different than the borrower account set on the loan. Otherwise the borrower wallet is implied from the assetsToRepay / assetsToRelease.

Please note that the owner account (for the investor) across all assets to be paid and released has to be the same.

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Query Params

Header Params

Body Params application/json

Examples

Responses

🟢200Success

application/json

Body

🟠400Bad Request

🟠401Unauthorized

🟠403Forbidden

🟠429Too Many Requests

🔴500Internal Server Error

Request Example

Shell

JavaScript

Java

Swift

curl --location --request PATCH 'https://vf-solana-api.dev.alphaledger.com/api/v1/loans/repay?solanaClusterId=SOLANA_DEVNET' \
--header 'x-request-id: f9860f73-a466-41f2-a083-34eeb1cc3a3c' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "itemData": {
        "defiProtocol": "LOOPSCALE",
        "escrow": {
            "onchainId": "GPjDgRPhSuJSya5GbaCWkYCDqcyL6N3ZBge9XMJsDton",
            "offchainId": "1b03ae9a-348c-4c18-8727-20c7c4ae7a0a",
            "offchainReferences": {
                "alId": "ALFNDPF000153778",
                "organizationExternalId": "ALT",
                "accountNumber": "ALT10000233",
                "code": "some-authority",
                "type": "WALLET"
            },
            "isOtherTenantSigner": false,
            "otherTenantOrganizationExternalId": "ALIM",
            "offPlatform": false
        },
        "itemsToRepay": [
            {
                "positionLookup": {
                    "position": {
                        "onchainId": "GPjDgRPhSuJSya5GbaCWkYCDqcyL6N3ZBge9XMJsDton",
                        "offchainId": "1b03ae9a-348c-4c18-8727-20c7c4ae7a0a",
                        "offchainReferences": {
                            "alId": "ALFNDPF000153778",
                            "organizationExternalId": "ALT",
                            "accountNumber": "ALT10000233",
                            "code": "some-authority",
                            "type": "WALLET"
                        },
                        "isOtherTenantSigner": false,
                        "otherTenantOrganizationExternalId": "ALIM",
                        "offPlatform": false
                    },
                    "owner": {
                        "onchainId": "GPjDgRPhSuJSya5GbaCWkYCDqcyL6N3ZBge9XMJsDton",
                        "offchainId": "1b03ae9a-348c-4c18-8727-20c7c4ae7a0a",
                        "offchainReferences": {
                            "alId": "ALFNDPF000153778",
                            "organizationExternalId": "ALT",
                            "accountNumber": "ALT10000233",
                            "code": "some-authority",
                            "type": "WALLET"
                        },
                        "isOtherTenantSigner": false,
                        "otherTenantOrganizationExternalId": "ALIM",
                        "offPlatform": false
                    },
                    "financialInstrument": {
                        "onchainId": "GPjDgRPhSuJSya5GbaCWkYCDqcyL6N3ZBge9XMJsDton",
                        "offchainId": "1b03ae9a-348c-4c18-8727-20c7c4ae7a0a",
                        "offchainReferences": {
                            "alId": "ALFNDPF000153778",
                            "organizationExternalId": "ALT",
                            "accountNumber": "ALT10000233",
                            "code": "some-authority",
                            "type": "WALLET"
                        },
                        "isOtherTenantSigner": false,
                        "otherTenantOrganizationExternalId": "ALIM",
                        "offPlatform": false
                    },
                    "mintAuthority": {
                        "onchainId": "GPjDgRPhSuJSya5GbaCWkYCDqcyL6N3ZBge9XMJsDton",
                        "offchainId": "1b03ae9a-348c-4c18-8727-20c7c4ae7a0a",
                        "offchainReferences": {
                            "alId": "ALFNDPF000153778",
                            "organizationExternalId": "ALT",
                            "accountNumber": "ALT10000233",
                            "code": "some-authority",
                            "type": "WALLET"
                        },
                        "isOtherTenantSigner": false,
                        "otherTenantOrganizationExternalId": "ALIM",
                        "offPlatform": false
                    },
                    "freezeAuthority": {
                        "onchainId": "GPjDgRPhSuJSya5GbaCWkYCDqcyL6N3ZBge9XMJsDton",
                        "offchainId": "1b03ae9a-348c-4c18-8727-20c7c4ae7a0a",
                        "offchainReferences": {
                            "alId": "ALFNDPF000153778",
                            "organizationExternalId": "ALT",
                            "accountNumber": "ALT10000233",
                            "code": "some-authority",
                            "type": "WALLET"
                        },
                        "isOtherTenantSigner": false,
                        "otherTenantOrganizationExternalId": "ALIM",
                        "offPlatform": false
                    }
                },
                "amount": 100.5,
                "repayAll": false,
                "transferFrom": {
                    "position": {
                        "onchainId": "GPjDgRPhSuJSya5GbaCWkYCDqcyL6N3ZBge9XMJsDton",
                        "offchainId": "1b03ae9a-348c-4c18-8727-20c7c4ae7a0a",
                        "offchainReferences": {
                            "alId": "ALFNDPF000153778",
                            "organizationExternalId": "ALT",
                            "accountNumber": "ALT10000233",
                            "code": "some-authority",
                            "type": "WALLET"
                        },
                        "isOtherTenantSigner": false,
                        "otherTenantOrganizationExternalId": "ALIM",
                        "offPlatform": false
                    },
                    "owner": {
                        "onchainId": "GPjDgRPhSuJSya5GbaCWkYCDqcyL6N3ZBge9XMJsDton",
                        "offchainId": "1b03ae9a-348c-4c18-8727-20c7c4ae7a0a",
                        "offchainReferences": {
                            "alId": "ALFNDPF000153778",
                            "organizationExternalId": "ALT",
                            "accountNumber": "ALT10000233",
                            "code": "some-authority",
                            "type": "WALLET"
                        },
                        "isOtherTenantSigner": false,
                        "otherTenantOrganizationExternalId": "ALIM",
                        "offPlatform": false
                    },
                    "financialInstrument": {
                        "onchainId": "GPjDgRPhSuJSya5GbaCWkYCDqcyL6N3ZBge9XMJsDton",
                        "offchainId": "1b03ae9a-348c-4c18-8727-20c7c4ae7a0a",
                        "offchainReferences": {
                            "alId": "ALFNDPF000153778",
                            "organizationExternalId": "ALT",
                            "accountNumber": "ALT10000233",
                            "code": "some-authority",
                            "type": "WALLET"
                        },
                        "isOtherTenantSigner": false,
                        "otherTenantOrganizationExternalId": "ALIM",
                        "offPlatform": false
                    },
                    "mintAuthority": {
                        "onchainId": "GPjDgRPhSuJSya5GbaCWkYCDqcyL6N3ZBge9XMJsDton",
                        "offchainId": "1b03ae9a-348c-4c18-8727-20c7c4ae7a0a",
                        "offchainReferences": {
                            "alId": "ALFNDPF000153778",
                            "organizationExternalId": "ALT",
                            "accountNumber": "ALT10000233",
                            "code": "some-authority",
                            "type": "WALLET"
                        },
                        "isOtherTenantSigner": false,
                        "otherTenantOrganizationExternalId": "ALIM",
                        "offPlatform": false
                    },
                    "freezeAuthority": {
                        "onchainId": "GPjDgRPhSuJSya5GbaCWkYCDqcyL6N3ZBge9XMJsDton",
                        "offchainId": "1b03ae9a-348c-4c18-8727-20c7c4ae7a0a",
                        "offchainReferences": {
                            "alId": "ALFNDPF000153778",
                            "organizationExternalId": "ALT",
                            "accountNumber": "ALT10000233",
                            "code": "some-authority",
                            "type": "WALLET"
                        },
                        "isOtherTenantSigner": false,
                        "otherTenantOrganizationExternalId": "ALIM",
                        "offPlatform": false
                    }
                },
                "mintAsset": false
            }
        ],
        "itemsToRelease": [
            {
                "positionLookup": {
                    "position": {
                        "onchainId": "GPjDgRPhSuJSya5GbaCWkYCDqcyL6N3ZBge9XMJsDton",
                        "offchainId": "1b03ae9a-348c-4c18-8727-20c7c4ae7a0a",
                        "offchainReferences": {
                            "alId": "ALFNDPF000153778",
                            "organizationExternalId": "ALT",
                            "accountNumber": "ALT10000233",
                            "code": "some-authority",
                            "type": "WALLET"
                        },
                        "isOtherTenantSigner": false,
                        "otherTenantOrganizationExternalId": "ALIM",
                        "offPlatform": false
                    },
                    "owner": {
                        "onchainId": "GPjDgRPhSuJSya5GbaCWkYCDqcyL6N3ZBge9XMJsDton",
                        "offchainId": "1b03ae9a-348c-4c18-8727-20c7c4ae7a0a",
                        "offchainReferences": {
                            "alId": "ALFNDPF000153778",
                            "organizationExternalId": "ALT",
                            "accountNumber": "ALT10000233",
                            "code": "some-authority",
                            "type": "WALLET"
                        },
                        "isOtherTenantSigner": false,
                        "otherTenantOrganizationExternalId": "ALIM",
                        "offPlatform": false
                    },
                    "financialInstrument": {
                        "onchainId": "GPjDgRPhSuJSya5GbaCWkYCDqcyL6N3ZBge9XMJsDton",
                        "offchainId": "1b03ae9a-348c-4c18-8727-20c7c4ae7a0a",
                        "offchainReferences": {
                            "alId": "ALFNDPF000153778",
                            "organizationExternalId": "ALT",
                            "accountNumber": "ALT10000233",
                            "code": "some-authority",
                            "type": "WALLET"
                        },
                        "isOtherTenantSigner": false,
                        "otherTenantOrganizationExternalId": "ALIM",
                        "offPlatform": false
                    },
                    "mintAuthority": {
                        "onchainId": "GPjDgRPhSuJSya5GbaCWkYCDqcyL6N3ZBge9XMJsDton",
                        "offchainId": "1b03ae9a-348c-4c18-8727-20c7c4ae7a0a",
                        "offchainReferences": {
                            "alId": "ALFNDPF000153778",
                            "organizationExternalId": "ALT",
                            "accountNumber": "ALT10000233",
                            "code": "some-authority",
                            "type": "WALLET"
                        },
                        "isOtherTenantSigner": false,
                        "otherTenantOrganizationExternalId": "ALIM",
                        "offPlatform": false
                    },
                    "freezeAuthority": {
                        "onchainId": "GPjDgRPhSuJSya5GbaCWkYCDqcyL6N3ZBge9XMJsDton",
                        "offchainId": "1b03ae9a-348c-4c18-8727-20c7c4ae7a0a",
                        "offchainReferences": {
                            "alId": "ALFNDPF000153778",
                            "organizationExternalId": "ALT",
                            "accountNumber": "ALT10000233",
                            "code": "some-authority",
                            "type": "WALLET"
                        },
                        "isOtherTenantSigner": false,
                        "otherTenantOrganizationExternalId": "ALIM",
                        "offPlatform": false
                    }
                },
                "amount": 100.5,
                "relaeaseAll": false,
                "transferTo": {
                    "position": {
                        "onchainId": "GPjDgRPhSuJSya5GbaCWkYCDqcyL6N3ZBge9XMJsDton",
                        "offchainId": "1b03ae9a-348c-4c18-8727-20c7c4ae7a0a",
                        "offchainReferences": {
                            "alId": "ALFNDPF000153778",
                            "organizationExternalId": "ALT",
                            "accountNumber": "ALT10000233",
                            "code": "some-authority",
                            "type": "WALLET"
                        },
                        "isOtherTenantSigner": false,
                        "otherTenantOrganizationExternalId": "ALIM",
                        "offPlatform": false
                    },
                    "owner": {
                        "onchainId": "GPjDgRPhSuJSya5GbaCWkYCDqcyL6N3ZBge9XMJsDton",
                        "offchainId": "1b03ae9a-348c-4c18-8727-20c7c4ae7a0a",
                        "offchainReferences": {
                            "alId": "ALFNDPF000153778",
                            "organizationExternalId": "ALT",
                            "accountNumber": "ALT10000233",
                            "code": "some-authority",
                            "type": "WALLET"
                        },
                        "isOtherTenantSigner": false,
                        "otherTenantOrganizationExternalId": "ALIM",
                        "offPlatform": false
                    },
                    "financialInstrument": {
                        "onchainId": "GPjDgRPhSuJSya5GbaCWkYCDqcyL6N3ZBge9XMJsDton",
                        "offchainId": "1b03ae9a-348c-4c18-8727-20c7c4ae7a0a",
                        "offchainReferences": {
                            "alId": "ALFNDPF000153778",
                            "organizationExternalId": "ALT",
                            "accountNumber": "ALT10000233",
                            "code": "some-authority",
                            "type": "WALLET"
                        },
                        "isOtherTenantSigner": false,
                        "otherTenantOrganizationExternalId": "ALIM",
                        "offPlatform": false
                    },
                    "mintAuthority": {
                        "onchainId": "GPjDgRPhSuJSya5GbaCWkYCDqcyL6N3ZBge9XMJsDton",
                        "offchainId": "1b03ae9a-348c-4c18-8727-20c7c4ae7a0a",
                        "offchainReferences": {
                            "alId": "ALFNDPF000153778",
                            "organizationExternalId": "ALT",
                            "accountNumber": "ALT10000233",
                            "code": "some-authority",
                            "type": "WALLET"
                        },
                        "isOtherTenantSigner": false,
                        "otherTenantOrganizationExternalId": "ALIM",
                        "offPlatform": false
                    },
                    "freezeAuthority": {
                        "onchainId": "GPjDgRPhSuJSya5GbaCWkYCDqcyL6N3ZBge9XMJsDton",
                        "offchainId": "1b03ae9a-348c-4c18-8727-20c7c4ae7a0a",
                        "offchainReferences": {
                            "alId": "ALFNDPF000153778",
                            "organizationExternalId": "ALT",
                            "accountNumber": "ALT10000233",
                            "code": "some-authority",
                            "type": "WALLET"
                        },
                        "isOtherTenantSigner": false,
                        "otherTenantOrganizationExternalId": "ALIM",
                        "offPlatform": false
                    }
                },
                "burnAsset": false
            }
        ],
        "submitTransaction": true
    },
    "solanaTransactionConfig": {
        "feePayer": {
            "onchainId": "GPjDgRPhSuJSya5GbaCWkYCDqcyL6N3ZBge9XMJsDton",
            "offchainId": "1b03ae9a-348c-4c18-8727-20c7c4ae7a0a",
            "offchainReferences": {
                "alId": "ALFNDPF000153778",
                "organizationExternalId": "ALT",
                "accountNumber": "ALT10000233",
                "code": "some-authority",
                "type": "WALLET"
            },
            "isOtherTenantSigner": false,
            "otherTenantOrganizationExternalId": "ALIM",
            "offPlatform": false
        },
        "computeUnitConfig": {
            "enable": true,
            "limit": 1400000,
            "price": 35000,
            "priceEstimate": {
                "provider": "HELIUS",
                "calculationStrategy": "DEFAULT"
            }
        },
        "commitmentConfig": {
            "commitmentLevel": "processed"
        },
        "messageLifetimeStrategy": "RECENT_BLOCKHASH",
        "transactionVersion": "V0"
    },
    "tenancyConfig": {
        "overrideOrganizationExternalId": "ALIM"
    }
}'

Response Example

200 - Example 1

{
    "success": false,
    "offchainId": "ee36c656-aa74-4d6a-b23c-332c204cb202",
    "status": "SIGNED",
    "onchainId": "5nwo7XvhiVRpJasEzH5r3hGKJqaTxd7qVit3cedFJgESdAPrmawebMJu6fUKRfjXEaivuey7vBsW56xPxX76T1bm",
    "confirmationsCount": 2,
    "serializedMessage": "string",
    "errorMessage": "string",
    "txnTimestamp": "2025-10-21T16:17:45.035372Z"
}

Modified at 2025-12-05 08:59:24

Swap Collateral

Close Loan