Initialize Payment Session
POST/v1/payment/create-session-data
Signature
This field contains a hash value. This hash is constructed by performing a hashing calculation on a string built up by concatenating the following fields' values (in the given order):
- quoteCurrency
- cryptoWalletAddress
- partnerId
- partnerName
- secret word hashed with MD5 and then converted to uppercase
The default hashing algorithm Skrill accepts is SHA-256. To calculate the signature, you need to take the values of the fields listed above exactly as you are going to post them in the request, concatenate them, and perform a SHA-256 calculation on this string.
Secret Word
Secret word will be set by an authorized Skrill referral partner representative, who will be given access to the specific part of the Paysafe Partner's portal, during the onboarding process.
Request
- application/json
Body
required
Required data for session creation
The quote currency the customers wants to purchase
The fiat currency in which the customer wants to make the payment for the quote
Amount the customer wants to spend to purchase crypto
Crypto address in which the customer wants to transfer the crypto
Partner unique identifier
Partner's display name
Partner's transaction id
Preferred payment method
Partner's url address where they expect webhook
Success url provided from web3 wallet
Default url provided from web3 wallet
Failure url provided from web3 wallet
The country of the user (ISO3166-1 alpha-3)
Hash value of mandatory parameters values and secret word
Responses
- 200
- 400
- 409
- 500
OK
- application/json
- Schema
- Example (from schema)
- Example - SessionDataResponse
Schema
Unique identifier of crypto purchase session
Link used to redirect the customer to start crypto purchase session
Hash value of mandatory parameters values and secret word
{
"sessionId": "341b1fae-f62a-41f7-b7f2-5403ff2fddd9",
"redirectLink": "https://crypto-onramp.skrill.com/payment?quoteCurrency=BTC&cryptoWalletAddress=3J98t1WpEZ73CNmQviecrnyiWrnqRhWNLy&partnerId=12345&partnerName=YourName&sessionId=01964883-7e02-437f-a5b0-d5e73063a63f",
"signature": "126947a2d19dd25698fd8ed51bc0e5b2378341e6cd96947a48b93686a3f62261"
}
{
"sessionId": "341b1fae-f62a-41f7-b7f2-5403ff2fddd9",
"redirectLink": "https://crypto-onramp.skrill.com/payment?quoteCurrency=BTC&cryptoWalletAddress=3J98t1WpEZ73CNmQviecrnyiWrnqRhWNLy&partnerId=12345&partnerName=YourName&sessionId=01964883-7e02-437f-a5b0-d5e73063a63f",
"signature": "126947a2d19dd25698fd8ed51bc0e5b2378341e6cd96947a48b93686a3f62261"
}
Bad Request
- application/json
- Schema
- Example (from schema)
Schema
Array [
]
error
object
Additional details about an error
The error code.
A description of the error.
Details of any parameter value errors.
fieldErrors
object[]
Identifies the JSON request field.
The problem associated with the field.
{
"error": {
"code": "string",
"message": "string",
"details": [
"string"
],
"fieldErrors": [
{
"field": "string",
"error": "string"
}
]
}
}
Conflict - duplicated data
- application/json
- Schema
- Example (from schema)
- conflict
Schema
Array [
]
error
object
Additional details about an error
The error code.
A description of the error.
Details of any parameter value errors.
fieldErrors
object[]
Identifies the JSON request field.
The problem associated with the field.
{
"error": {
"code": "string",
"message": "string",
"details": [
"string"
],
"fieldErrors": [
{
"field": "string",
"error": "string"
}
]
}
}
{
"error": {
"code": 8029,
"message": "Provided partner transaction ID already exists for partner!",
"details": [
"The partner initiated a payment session with a transaction id that already exists."
]
}
}
General Error
- application/json
- Schema
- Example (from schema)
Schema
Array [
]
error
object
Additional details about an error
The error code.
A description of the error.
Details of any parameter value errors.
fieldErrors
object[]
Identifies the JSON request field.
The problem associated with the field.
{
"error": {
"code": "string",
"message": "string",
"details": [
"string"
],
"fieldErrors": [
{
"field": "string",
"error": "string"
}
]
}
}