DepositRequest
Structure for initiating Deposit process.
Deposit amount in currency minor units.
Currency alphabetic code as specified by ISO 4217
Possible values: >= 3 characters
and <= 3 characters
EUR
paymentInstrumentReference object
Represents a reference to a Payment Instrument, used for Deposit or Withdrawal.
Instrument identifier.
1001
Represents the type of the instrument.
| Value | Description| |---|---| | SEPA_BANK_ACCOUNT| SEPA Bank account | | UK_BANK_ACCOUNT | UK Bank account | | US_BANK_ACCOUNT | US Bank account | | CCI_BANK_ACCOUNT | CCI Bank account | | CARD | Card |
Possible values: [SEPA_BANK_ACCOUNT
, UK_BANK_ACCOUNT
, US_BANK_ACCOUNT
, CCI_BANK_ACCOUNT
, CARD
]
CARD
This is the merchant reference number created by the merchant and submitted as part of the request. It must be unique for each request and allows cross referencing objects from merchant system to embedded wallet objects.
Possible values: <= 255 characters
4bc2deb3-9766-4598-a08e-a98b60615936
returnUrls object[]
Links to redirect customer back during transaction flow.
The link rel
defines a semantic of the merchant url to redirect the payment flow.
DEFAULT
- The default return URL that will be used if specific status return URL is not defined or cannot be determined.
ON_COMPLETED
- Paysafe will return to this merchant url post succeful payment authorisation.
ON_FAILED
- Paysafe will return to this merchant url post if the authorisation failed.
ON_CANCELLED
- Paysafe will return to this merchant url post if payment is cancelled in PSP.
Possible values: [DEFAULT
, ON_COMPLETED
, ON_FAILED
, ON_CANCELLED
]
DEFAULT
DEFAULT
The url to be used for further actions.
https://api.paysafe.com/card/redirect/372b5ee7-6360-4403-b444-164f8f1d2709
HTTP request method.
Possible values: [GET
, POST
]
GET
paymentProperties object[]
List of payment option specific properties.
Payment property key. Defines available payment property key and their meaning.
Card payment properties:
- CARD_CVV - Card CVV is required to confirm the card payment during deposit.
- Valid value:
123
- Valid value:
- CARD_SAVE_INSTRUMENT - The user agrees to save the card for further payments.
- Valid value:
true
- Valid value:
- PAYMENT_CONFIRMATION - For PCI-DSS level 3 partners card information is collected in Paysafe hosted interface. |Valid values|Description| |---|---| |EMBEDDED|Default The payment is confirmed in the hosted Paysafe interface | |OUTSOURCED| The payment flow is returned to caller after collection of card data|
Possible values: [CARD_CVV
, CARD_SAVE_INSTRUMENT
, SAVE_RECIPIENT
, PAYMENT_CONFIRMATION
]
The value of the payment property.
Payment option requested by customer.
Possible values: [RAPID_TRANSFER
, BANK_TRANSFER
, CARD
, PAYSAFECASH
, PAGO_EFECTIVO
]
CARD
fees object[]
Customer fees attached to the transaction.
Amount of the merchant payment, in mintor units. If currency
is not specified, then the main transaction currency is used.
0
1000
Currency alphabetic code as specified by ISO 4217
Possible values: >= 3 characters
and <= 3 characters
EUR
Fee payment reason.
- SENDER_FEE - Fee that will be applied to sender party of transfer collected into partner merchant wallet.
- RECIPIENT_FEE - Fee that will be applied to recipient client of transfer collected into partner merchant wallet.
- DEPOSIT_FEE - Fee charged for deposit transactions collected into partner merchant wallet.
- WITHDRAWAL_FEE - Fee charged for withdrawal transactions collected into partner merchant wallet.
- MERCHANT_FEE - Fee for the payment service collected into partner merchant wallet.
- PAYSAFE_FEE - Fee collected by Paysafe for the provided payment service. Usually Paysafe Fee is not directly applied to customer transactions.
- ATM_FEE - Fee for ATM service, when using prepaid cards.
- FX_FEE - Fee applied, when payment requires currency exchange.
- OTHER_FEE - It could be used for any additional, unspecified fees that may be applied to a transaction
Possible values: [MERCHANT_FEE
, ATM_FEE
, FX_FEE
, PAYSAFE_FEE
, OTHER_FEE
, SENDER_FEE
, RECIPIENT_FEE
, DEPOSIT_FEE
, WITHDRAWAL_FEE
]
OTHER_FEE
The target merchant wallet id.
500005
Currency alphabetic code as specified by ISO 4217
Possible values: >= 3 characters
and <= 3 characters
EUR
The target account in which the payment is accepted. If not specified the account is determined by the main transaction currency.
100001
{
"amount": 0,
"currencyCode": "EUR",
"paymentInstrumentReference": {
"id": "1001",
"instrumentType": "CARD"
},
"merchantRefNum": "4bc2deb3-9766-4598-a08e-a98b60615936",
"returnUrls": [
{
"rel": "DEFAULT",
"href": "https://api.paysafe.com/card/redirect/372b5ee7-6360-4403-b444-164f8f1d2709",
"method": "GET"
}
],
"paymentProperties": [
{
"key": "CARD_CVV",
"value": "string"
}
],
"paymentOption": "CARD",
"fees": [
{
"amount": 1000,
"currency": "EUR",
"paymentReason": "OTHER_FEE",
"merchantId": "500005",
"recipientCurrency": "EUR",
"merchantAccountId": "100001"
}
]
}