Skrill Wallet (legacy)

Skrill Wallet — alternative payment method to perform purchases, payouts, and refunds via e-wallets. Purchases are processed by using Payment Page and Gate, COF payments, payouts, and refunds are processed by using Gate.

Note:

A new technical implementation is available for working with the Skrill Wallet method. It is described in the Skrill Wallet section.

For the information on how to switch to a new implementation refer to the key account manager.

Currencies and countries supported by Skrill Wallet

There are no limits on the countries. Supported currencies: AUD, CAD, CHF, DKK, EUR, GBP, HUF, NOK, PLN, RON, SEK, USD.

For more information about currency code values, see Currency codes.

Purchase processing by using Payment Page

To open Payment Page with pre-selected payment method Skrill Wallet, pass skrill in the force_payment_method parameter.

Purchase processing by using Gate

Purchase processing by using Gate requires further elaboration on your side. You need to implement the functionality for redirecting the customer to the URL received in response to a request for purchase. This URL contains a unique session identifier (SID) on the Skrill Wallet side.

Request for purchase

POST the /v2/payment/skrill/sale request.

Figure: Example of request for purchase

{
  "general": {
    "project_id": 238,
    "payment_id": "SKRILL_SALE_12345",
    "signature": "t8qap+aD70GdZwlTW93kFCOqaWXP/AITLKLkN4TkHd73UfSt9F7dni...=="
  },
  "customer": {
    "ip_address": "127.0.0.1"
  },
  "payment": {
    "amount": 1000,
    "currency": "EUR"
  },
  "return_url": {
    "success": "http://google.com",
    "decline": "http://mail.ru"
  }
}

COF payment processing

Payment method Skrill Wallet provides the ability to perform COF payments of two types: OneClick and regular payments. For more information about COF payments, see Credential-on-file (COF) purchases.

In the Skrill Wallet payment method, COF payments of the OneClick type are performed by using the Skrill 1-Tap service. This service allows to make payments in "one tap" using previously saved wallet.

Request for OneClick registration

POST the /v2/payment/skrill/sale request.

The request should contain the sign of COF-payment true in the parameter recurring_register.

Figure: Example of request for OneClick registration

 {
  "general": {
    "project_id": 238,
    "payment_id": "TEST_15427007172789",
    "signature": "DH0v2pZnkK9hwytQ6/ZtDSQh+wwxcO73wavlM0IrgP/ZZH7/...==",
  },
  "customer": {
    "id": "11112323",
    "ip_address": "87.245.207.226"
  },
  "return_url": {
    "success": "https://example.com/process/complete-redirect?wsid=obmbs3r9rf7ersesri43jsv712",
    "decline": "https://example.com/process/complete-redirect?wsid=obmbs3r9rf7ersesri43jsv712",
    "return": "https://example.com/process/complete-redirect?wsid=obmbs3r9rf7ersesri43jsv712&redirect_after_return=0"
  },
  "payment": {
    "amount": 1000,
    "currency": "EUR",
    "description": "TEST_1542700717278"
  },
  "recurring": {
    "register": true
  }
}

After the OneClick is registered, the customer can perform COF payments of OneClick type using the Skrill 1-Tap service.

Request for OneClick

POST the /v2/payment/skrill/1-tap request.

The request should contain the identifier of COF payment.

Figure: Example of request for OneClick

 {
  "general": {
    "project_id": 238,
    "payment_id": "SKRILL_1CLICK_PAYMENT_111",
    "signature": "I6p18ATsJ/RD+gFdc4XFg8go/oDUt7wTthWfGIcz...=="
  },
  "customer": {
    "ip_address": "127.0.0.1"
  },
  "payment": {
    "amount": 3000,
    "currency": "EUR"
  },
  "recurring": {
    "id": 1010230038
  }
}

Request for regular payments registration

POST the /v2/payment/skrill/sale request.

The request should contain information about the frequency, amount, start and end dates of the regular payments. The regular payments start date specified in the start_date parameter must be at least one day later than the registration date.

Figure: Example of request for regular payments registration

{
  "general": {
    "project_id": 238,
    "payment_id": "SKRILL_SALE_ID:pr0000011033",
    "signature": "f1iEkROzHxegKB+bHPGOmI0+w5RVXT0ypC9rK2KFPhwpQ+y37PER3...=="
  },
  "customer": {
    "ip_address": "127.0.0.1",
    "grace_period": 1
  },
  "recurring": {
    "register": true,
    "amount": 5000,
    "interval": 1,
    "cycle": "day",
    "start_date": "21-11-2018",
    "expiry_year": 2018,
    "expiry_month": 11,
    "expiry_day": 25
  },
  "payment": {
    "amount": 5000,
    "currency": "EUR",
    "description": "skrill payment"
  },
  "return_url": {
    "success": "http://google.com",
    "decline": "http://test.com"
  }
}

Request for regular payments update

POST the /v2/payment/skrill/recurring/update request.

Figure: Example of request for regular payments renewal

 {
  "general": {
    "project_id": 238,
    "payment_id": "TEST_15427007172789",
    "signature": "DH0v2pZnkK9hwytQ6/ZtDSQh+wwx/OqrWdbltzO5GMSkzd0...==",
  },
  "customer": {
    "ip_address": "87.245.207.226"
  },
  "payment": {
    "amount": 1000,
    "currency": "EUR"
  },
  "recurring": {
    "id": 1234567890,
    "expiry_year": 2030,
    "expiry_month": 11,
    "expiry_day": 25
  }
}

Request for regular payments cancellation

POST the /v2/payment/skrill/recurring/cancel request.

Figure: Example of request for regular payments cancellation

 {
  "general": {
    "project_id": 238,
    "payment_id": "TEST_15427007172789",
    "signature": "DH0v2pZnkK9hwytQ6/ZtDSQh+wwx/OqrWdbltzO5GMSkzd0Iq6lM2v...==",
  },
  "customer": {
    "ip_address": "87.245.207.226"
  },
  "payment": {
    "amount": 1000,
    "currency": "EUR"
  },
  "recurring": {
    "id": 1234567890
  }
}

Payout processing

The minimal payment amount is 10.00 USD (or equivalent), maximum amount is 10,000.00 USD (or equivalent).

Request for payout

POST the /v2/payment/skrill/payout request.

Figure: Example of request for payout

{
  "general": {
    "project_id": 238,
    "payment_id": "1122334414",
    "signature": "MkWH46nni0tAP6w9C1oX1+pyJXuenY8vBT9QGrilc+CXcUU/xfMYNWjeF...=="
  },
  "customer": {
    "id": "test_customer",
    "ip_address": "127.0.0.1"
  },
  "payment": {
    "amount": 2000,
    "currency": "EUR",
    "description": "skrill payment"
  }
}

Refund processing

There is no limits on payment amount.

Request for refund

POST the /v2/payment/skrill/refund request.

Figure: Example of request for refund

{
  "general": {
    "project_id": 238,
    "payment_id": "TEST_SALE_SKRILL-1",
    "signature": "t2YTnb98835ov1aZzvRtUr2l0w/tFaVMAvfU1h3zzYKVBvHlcqR4IKs6foVy1Z+CMWSkqYxsBsTmLnMycV3Muw=="
  },
  "customer": {
    "id": "1",
    "ip_address": "87.245.207.226"
  },
  "return_url": {
    "success": "https://paymentpage.com/process/complete-redirect?wsid=9lsj2lqkr9ft5jpaug1h3403v1",
    "decline": "https://paymentpage.com/process/complete-redirect?wsid=9lsj2lqkr9ft5jpaug1h3403v1",
    "return": "https://paymentpage.com/process/complete-redirect?wsid=9lsj2lqkr9ft5jpaug1h3403v1&redirect_after_return=0"
  },
  "payment": {
    "amount": 1000,
    "currency": "USD",
    "description": "TEST_SALE_SKRILL-1"
  }
}