Skip to content

Latest commit

 

History

History
336 lines (230 loc) · 10.5 KB

File metadata and controls

336 lines (230 loc) · 10.5 KB

paystack.TransferRecipient

All URIs are relative to https://api.paystack.co

Method HTTP request Description
bulk POST /transferrecipient/bulk Bulk Create Transfer Recipient
create POST /transferrecipient Create Transfer Recipient
fetch GET /transferrecipient/{code} Fetch Transfer recipient
list GET /transferrecipient List Transfer Recipients
transferrecipient_code_delete DELETE /transferrecipient/{code} Delete Transfer Recipient
transferrecipient_code_put PUT /transferrecipient/{code} Update Transfer recipient

bulk

Response bulk(batch)

Bulk Create Transfer Recipient

Example

  • Bearer Authentication (bearerAuth):
import paystack
from paystack.rest import ApiException
from pprint import pprint


batch = paystack.TransferRecipientCreate() # list[TransferRecipientCreate] | A list of transfer recipient object. Each object should contain type, name, and bank_code.  Any Create Transfer Recipient param can also be passed.

# Bulk Create Transfer Recipient

response = paystack.TransferRecipient.bulk(batch)
pprint(response)

Parameters

Name Type Description Notes
batch list[TransferRecipientCreate] A list of transfer recipient object. Each object should contain type, name, and bank_code. Any Create Transfer Recipient param can also be passed.

Return type

Response

Authorization

bearerAuth

HTTP request headers

  • Content-Type: application/x-www-form-urlencoded, application/json
  • Accept: application/json

HTTP response details

Status code Description Response headers
200 Request successful -
401 Unauthorized operation -
0 Server error -

[Back to top] [Back to API list] [Back to Model list] [Back to README]

create

Response create(type, name, account_number, bank_code, description=description, currency=currency, authorization_code=authorization_code, metadata=metadata)

Create Transfer Recipient

Example

  • Bearer Authentication (bearerAuth):
import paystack
from paystack.rest import ApiException
from pprint import pprint


type = 'type_example' # str | Recipient Type (Only nuban at this time)
name = 'name_example' # str | Recipient's name
account_number = 'account_number_example' # str | Recipient's bank account number
bank_code = 'bank_code_example' # str | Recipient's bank code. You can get the list of Bank Codes by calling the List Banks endpoint
description = 'description_example' # str | A description for this recipient (optional)
currency = 'currency_example' # str | Currency for the account receiving the transfer (optional)
authorization_code = 'authorization_code_example' # str | An authorization code from a previous transaction (optional)
metadata = 'metadata_example' # str | Stringified JSON object of custom data (optional)

# Create Transfer Recipient

response = paystack.TransferRecipient.create(type, name, account_number, bank_code, description=description, currency=currency, authorization_code=authorization_code, metadata=metadata)
pprint(response)

Parameters

Name Type Description Notes
type str Recipient Type (Only nuban at this time)
name str Recipient's name
account_number str Recipient's bank account number
bank_code str Recipient's bank code. You can get the list of Bank Codes by calling the List Banks endpoint
description str A description for this recipient [optional]
currency str Currency for the account receiving the transfer [optional]
authorization_code str An authorization code from a previous transaction [optional]
metadata str Stringified JSON object of custom data [optional]

Return type

Response

Authorization

bearerAuth

HTTP request headers

  • Content-Type: application/x-www-form-urlencoded, application/json
  • Accept: application/json

HTTP response details

Status code Description Response headers
201 Resource created -
401 Unauthorized operation -
0 Server error -

[Back to top] [Back to API list] [Back to Model list] [Back to README]

fetch

Response fetch(code)

Fetch Transfer recipient

Example

  • Bearer Authentication (bearerAuth):
import paystack
from paystack.rest import ApiException
from pprint import pprint


code = 'code_example' # str | Transfer recipient code

# Fetch Transfer recipient

response = paystack.TransferRecipient.fetch(code)
pprint(response)

Parameters

Name Type Description Notes
code str Transfer recipient code

Return type

Response

Authorization

bearerAuth

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

HTTP response details

Status code Description Response headers
200 Request successful -
401 Unauthorized operation -
404 Entity not found -
0 Server error -

[Back to top] [Back to API list] [Back to Model list] [Back to README]

list

Response list(per_page=per_page, page=page, _from=_from, to=to)

List Transfer Recipients

Example

  • Bearer Authentication (bearerAuth):
import paystack
from paystack.rest import ApiException
from pprint import pprint


per_page = 56 # int | Number of records to fetch per page (optional)
page = 56 # int | The section to retrieve (optional)
_from = '2013-10-20T19:20:30+01:00' # datetime | The start date (optional)
to = '2013-10-20T19:20:30+01:00' # datetime | The end date (optional)

# List Transfer Recipients

response = paystack.TransferRecipient.list(per_page=per_page, page=page, _from=_from, to=to)
pprint(response)

Parameters

Name Type Description Notes
per_page int Number of records to fetch per page [optional]
page int The section to retrieve [optional]
_from datetime The start date [optional]
to datetime The end date [optional]

Return type

Response

Authorization

bearerAuth

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

HTTP response details

Status code Description Response headers
200 Request successful -
401 Unauthorized operation -
404 Entity not found -
0 Server error -

[Back to top] [Back to API list] [Back to Model list] [Back to README]

transferrecipient_code_delete

Response transferrecipient_code_delete(code)

Delete Transfer Recipient

Example

  • Bearer Authentication (bearerAuth):
import paystack
from paystack.rest import ApiException
from pprint import pprint


code = 'code_example' # str | Transfer recipient code

# Delete Transfer Recipient

response = paystack.TransferRecipient.transferrecipient_code_delete(code)
pprint(response)

Parameters

Name Type Description Notes
code str Transfer recipient code

Return type

Response

Authorization

bearerAuth

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

HTTP response details

Status code Description Response headers
200 Request successful -
401 Unauthorized operation -
404 Entity not found -
0 Server error -

[Back to top] [Back to API list] [Back to Model list] [Back to README]

transferrecipient_code_put

Response transferrecipient_code_put(code, name=name, email=email)

Update Transfer recipient

Example

  • Bearer Authentication (bearerAuth):
import paystack
from paystack.rest import ApiException
from pprint import pprint


code = 'code_example' # str | Transfer recipient code
name = 'name_example' # str | Recipient's name (optional)
email = 'email_example' # str | Recipient's email address (optional)

# Update Transfer recipient

response = paystack.TransferRecipient.transferrecipient_code_put(code, name=name, email=email)
pprint(response)

Parameters

Name Type Description Notes
code str Transfer recipient code
name str Recipient's name [optional]
email str Recipient's email address [optional]

Return type

Response

Authorization

bearerAuth

HTTP request headers

  • Content-Type: application/x-www-form-urlencoded, application/json
  • Accept: application/json

HTTP response details

Status code Description Response headers
200 Request successful -
401 Unauthorized operation -
404 Entity not found -
0 Server error -

[Back to top] [Back to API list] [Back to Model list] [Back to README]