Payout service APIs
Payout service APIs (1.0.0)
https://docs.ripple.com/_mock/products/payments-direct/api-docs/payout-service/payout-service/
- Mock server
https://docs.ripple.com/_mock/products/payments-direct/api-docs/payout-service/payout-service/v1/payout_methods
- curl
- Python
- JavaScript
curl -i -X GET \
'https://docs.ripple.com/_mock/products/payments-direct/api-docs/payout-service/payout-service/v1/payout_methods?country=string&partner_name=string&use_case=string&payout_currency=string&payout_method=string&payout_category=string' \
-H 'Authorization: Bearer <YOUR_TOKEN_HERE>'Returns all payout methods matching the criteria
Payout country as two-letter ISO 3166-1 Alpha-2 code
Holds the rules used to calculate fee
fee calculation rule. If set to REGULAR, find the matching range slabs, apply the percentage or fixed fee based on PayoutFeeType. A global/administrative fee can be applied on top of a slab fee.
maximum fee amount. Default to maximum number (no upper limit)
the calculation rule of payout fee element. By default, REGULAR. If set to AMINISTRACTIVE/GLOBAL, the fee should be applied to every transaction. If set to Hihger/Lower of Flat or Percentage fee, then the higher/lower amount of flat/pct fee will be applied
Holds the amount and unit of time it takes for a settlement to occur
Defines the limits for payouts min, max size of payment and the maximum amount per beneficiary
{ "content": [ { … } ], "page": { "size": 0, "total_elements": 0, "total_pages": 0, "number": 0 } }
The payout method to create.
Holds the rules used to calculate fee
fee calculation rule. If set to REGULAR, find the matching range slabs, apply the percentage or fixed fee based on PayoutFeeType. A global/administrative fee can be applied on top of a slab fee.
maximum fee amount. Default to maximum number (no upper limit)
the calculation rule of payout fee element. By default, REGULAR. If set to AMINISTRACTIVE/GLOBAL, the fee should be applied to every transaction. If set to Hihger/Lower of Flat or Percentage fee, then the higher/lower amount of flat/pct fee will be applied
Holds the amount and unit of time it takes for a settlement to occur
Defines the limits for payouts min, max size of payment and the maximum amount per beneficiary
- Mock server
https://docs.ripple.com/_mock/products/payments-direct/api-docs/payout-service/payout-service/v1/payout_methods
- curl
- Python
- JavaScript
curl -i -X POST \
https://docs.ripple.com/_mock/products/payments-direct/api-docs/payout-service/payout-service/v1/payout_methods \
-H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
-H 'Content-Type: application/json' \
-d '{
"payout_partner_id": "65606de6-d86e-468e-8e69-55184fddf40c",
"payout_category": "string",
"payout_method_name": "string",
"payout_method_display_name": "string",
"payout_method_description": "string",
"payout_country": "string",
"payout_currency": "string",
"supported_usecase": "string",
"rounding_rules": {
"payout_amount_fee_calculation_decimal_scale": 2
},
"fee_calculation_rule": "REGULAR",
"payout_fees": [
{
"currency": "AUD",
"from_amount": 0,
"to_amount": 1000,
"fee_amount": 5,
"fee_percent": 2,
"min_fee_amount": 25,
"max_fee_amount": 100,
"fee_type": "REGULAR",
"description": "Administrative/global fee, applied for each transaction"
}
],
"payout_settlement_times": {
"settlement_time": 0,
"settlement_time_unit": "string"
},
"payout_limits": {
"currency": "string",
"min_payment_size": "string",
"max_payment_size": "string",
"max_amount_per_beneficiary": "string"
},
"receiver_payout_method": "string"
}'Returns details about the created payout method
Payout country as two-letter ISO 3166-1 Alpha-2 code
Holds the rules used to calculate fee
fee calculation rule. If set to REGULAR, find the matching range slabs, apply the percentage or fixed fee based on PayoutFeeType. A global/administrative fee can be applied on top of a slab fee.
maximum fee amount. Default to maximum number (no upper limit)
the calculation rule of payout fee element. By default, REGULAR. If set to AMINISTRACTIVE/GLOBAL, the fee should be applied to every transaction. If set to Hihger/Lower of Flat or Percentage fee, then the higher/lower amount of flat/pct fee will be applied
Holds the amount and unit of time it takes for a settlement to occur
Defines the limits for payouts min, max size of payment and the maximum amount per beneficiary
{ "payout_method_id": "ec4c9578-6718-4d77-b850-74b3ea0bf0cd", "payout_partner_id": "65606de6-d86e-468e-8e69-55184fddf40c", "payout_partner_name": "Tranglo", "payout_category": "BANK | EWALLET | CASH_PICKUP | ATM", "payout_method_name": "tranglo_bank_treasury_AU_AUD_payout", "payout_method_display_name": "Tranglo treasury bank AUD payout in AT", "payout_method_description": "Tranglo bank (payout category) AUD payout in Australia (AT) for treasury use case", "payout_method_status": "ACTIVE", "payout_country": "AT", "payout_currency": "AUR", "supported_usecase": "TREASURY | P2P | B2B | B2C", "rounding_rules": { "payout_amount_fee_calculation_decimal_scale": 2 }, "fee_calculation_rule": "REGULAR", "payout_fees": [ { … } ], "payout_settlement_times": { "settlement_time": 0, "settlement_time_unit": "string" }, "payout_limits": { "currency": "string", "min_payment_size": "string", "max_payment_size": "string", "max_amount_per_beneficiary": "string" }, "receiver_payout_method": "string" }
- Mock server
https://docs.ripple.com/_mock/products/payments-direct/api-docs/payout-service/payout-service/v1/payout_methods/{payout_method_id}
- curl
- Python
- JavaScript
curl -i -X DELETE \
'https://docs.ripple.com/_mock/products/payments-direct/api-docs/payout-service/payout-service/v1/payout_methods/{payout_method_id}' \
-H 'Authorization: Bearer <YOUR_TOKEN_HERE>'- Mock server
https://docs.ripple.com/_mock/products/payments-direct/api-docs/payout-service/payout-service/v1/payout_methods/{payout_method_id}
- curl
- Python
- JavaScript
curl -i -X GET \
'https://docs.ripple.com/_mock/products/payments-direct/api-docs/payout-service/payout-service/v1/payout_methods/{payout_method_id}' \
-H 'Authorization: Bearer <YOUR_TOKEN_HERE>'Returns details about the payout method
Payout country as two-letter ISO 3166-1 Alpha-2 code
Holds the rules used to calculate fee
fee calculation rule. If set to REGULAR, find the matching range slabs, apply the percentage or fixed fee based on PayoutFeeType. A global/administrative fee can be applied on top of a slab fee.
maximum fee amount. Default to maximum number (no upper limit)
the calculation rule of payout fee element. By default, REGULAR. If set to AMINISTRACTIVE/GLOBAL, the fee should be applied to every transaction. If set to Hihger/Lower of Flat or Percentage fee, then the higher/lower amount of flat/pct fee will be applied
Holds the amount and unit of time it takes for a settlement to occur
Defines the limits for payouts min, max size of payment and the maximum amount per beneficiary
{ "payout_method_id": "ec4c9578-6718-4d77-b850-74b3ea0bf0cd", "payout_partner_id": "65606de6-d86e-468e-8e69-55184fddf40c", "payout_partner_name": "Tranglo", "payout_category": "BANK | EWALLET | CASH_PICKUP | ATM", "payout_method_name": "tranglo_bank_treasury_AU_AUD_payout", "payout_method_display_name": "Tranglo treasury bank AUD payout in AT", "payout_method_description": "Tranglo bank (payout category) AUD payout in Australia (AT) for treasury use case", "payout_method_status": "ACTIVE", "payout_country": "AT", "payout_currency": "AUR", "supported_usecase": "TREASURY | P2P | B2B | B2C", "rounding_rules": { "payout_amount_fee_calculation_decimal_scale": 2 }, "fee_calculation_rule": "REGULAR", "payout_fees": [ { … } ], "payout_settlement_times": { "settlement_time": 0, "settlement_time_unit": "string" }, "payout_limits": { "currency": "string", "min_payment_size": "string", "max_payment_size": "string", "max_amount_per_beneficiary": "string" }, "receiver_payout_method": "string" }
The payout method to update.
Payout country as two-letter ISO 3166-1 Alpha-2 code
Holds the rules used to calculate fee
fee calculation rule. If set to REGULAR, find the matching range slabs, apply the percentage or fixed fee based on PayoutFeeType. A global/administrative fee can be applied on top of a slab fee.
maximum fee amount. Default to maximum number (no upper limit)
the calculation rule of payout fee element. By default, REGULAR. If set to AMINISTRACTIVE/GLOBAL, the fee should be applied to every transaction. If set to Hihger/Lower of Flat or Percentage fee, then the higher/lower amount of flat/pct fee will be applied
Holds the amount and unit of time it takes for a settlement to occur
Defines the limits for payouts min, max size of payment and the maximum amount per beneficiary
- Mock server
https://docs.ripple.com/_mock/products/payments-direct/api-docs/payout-service/payout-service/v1/payout_methods/{payout_method_id}
- curl
- Python
- JavaScript
curl -i -X PUT \
'https://docs.ripple.com/_mock/products/payments-direct/api-docs/payout-service/payout-service/v1/payout_methods/{payout_method_id}' \
-H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
-H 'Content-Type: application/json' \
-d '{
"payout_method_id": "ec4c9578-6718-4d77-b850-74b3ea0bf0cd",
"payout_partner_id": "65606de6-d86e-468e-8e69-55184fddf40c",
"payout_partner_name": "Tranglo",
"payout_category": "BANK | EWALLET | CASH_PICKUP | ATM",
"payout_method_name": "tranglo_bank_treasury_AU_AUD_payout",
"payout_method_display_name": "Tranglo treasury bank AUD payout in AT",
"payout_method_description": "Tranglo bank (payout category) AUD payout in Australia (AT) for treasury use case",
"payout_method_status": "ACTIVE",
"payout_country": "AT",
"payout_currency": "AUR",
"supported_usecase": "TREASURY | P2P | B2B | B2C",
"rounding_rules": {
"payout_amount_fee_calculation_decimal_scale": 2
},
"fee_calculation_rule": "REGULAR",
"payout_fees": [
{
"currency": "AUD",
"from_amount": 0,
"to_amount": 1000,
"fee_amount": 5,
"fee_percent": 2,
"min_fee_amount": 25,
"max_fee_amount": 100,
"fee_type": "REGULAR",
"description": "Administrative/global fee, applied for each transaction"
}
],
"payout_settlement_times": {
"settlement_time": 0,
"settlement_time_unit": "string"
},
"payout_limits": {
"currency": "string",
"min_payment_size": "string",
"max_payment_size": "string",
"max_amount_per_beneficiary": "string"
},
"receiver_payout_method": "string"
}'Returns updated details about the payout method
Payout country as two-letter ISO 3166-1 Alpha-2 code
Holds the rules used to calculate fee
fee calculation rule. If set to REGULAR, find the matching range slabs, apply the percentage or fixed fee based on PayoutFeeType. A global/administrative fee can be applied on top of a slab fee.
maximum fee amount. Default to maximum number (no upper limit)
the calculation rule of payout fee element. By default, REGULAR. If set to AMINISTRACTIVE/GLOBAL, the fee should be applied to every transaction. If set to Hihger/Lower of Flat or Percentage fee, then the higher/lower amount of flat/pct fee will be applied
Holds the amount and unit of time it takes for a settlement to occur
Defines the limits for payouts min, max size of payment and the maximum amount per beneficiary
{ "payout_method_id": "ec4c9578-6718-4d77-b850-74b3ea0bf0cd", "payout_partner_id": "65606de6-d86e-468e-8e69-55184fddf40c", "payout_partner_name": "Tranglo", "payout_category": "BANK | EWALLET | CASH_PICKUP | ATM", "payout_method_name": "tranglo_bank_treasury_AU_AUD_payout", "payout_method_display_name": "Tranglo treasury bank AUD payout in AT", "payout_method_description": "Tranglo bank (payout category) AUD payout in Australia (AT) for treasury use case", "payout_method_status": "ACTIVE", "payout_country": "AT", "payout_currency": "AUR", "supported_usecase": "TREASURY | P2P | B2B | B2C", "rounding_rules": { "payout_amount_fee_calculation_decimal_scale": 2 }, "fee_calculation_rule": "REGULAR", "payout_fees": [ { … } ], "payout_settlement_times": { "settlement_time": 0, "settlement_time_unit": "string" }, "payout_limits": { "currency": "string", "min_payment_size": "string", "max_payment_size": "string", "max_amount_per_beneficiary": "string" }, "receiver_payout_method": "string" }