Remit to Bank Account

post https://sandbox.paddieswitch.com/api/v1/transactions/remittances/bank-account

This method charges a bank account and sends payment to a recipient.

There are two bank account types

PERSONAL
BUSINESS

For PERSONAL bank account type, the beneficiary details object should be filled while the business beneficiary details object should be empty.

For BUSINESS bank account type, the business beneficiary details object should be filled while the beneficiary details object should be empty.

Body Params

accountNumber

string

required

Defaults to 1976010126

This is the beneficiary's bank account number

bankAccountType

string

required

Defaults to PERSONAL

This is the beneficiary bank account type E.g "PERSONAL" or "BUSINESS"

bankCode

string

required

Defaults to NGA10003

This is the beneficiary's bank code or identifier E.g NGA10003

bankName

string

required

Defaults to KEYSTONE BANK

This is the beneficiary bank name E.g for Business bank account type - "Emirates National Bank of Dubai"

beneficiaryAmount

double

required

Defaults to 5700

This is the credit amount the beneficiary receives

beneficiaryCountry

string

required

Defaults to NG

This is the recipient's country. E.g "NG" for Nigeria

beneficiaryCurrency

string

required

Defaults to NGN

This is the recipient's currency. E.g "NGN" for Nigeria Naira

beneficiaryDetails

object

required

Beneficiary Details

beneficiaryMobileNumber

string

Defaults to 08012345678

This is the beneficiary's mobile number e.g +2348012345678

branchCode

string

This is the beneficiary's bank branch code

businessBeneficiaryDetails

object

required

description

string

required

Defaults to Sample swift transaction

This is the narration or purpose of the transaction

identifier

string

required

Defaults to NGA10003

This is the unique bank identifier

quoteId

string

required

Defaults to QTBKRILIU5UTOE9NUG

This is the unique quotation Id gotten from the Quote for Bank Account response

remittancePurpose

string

required

Defaults to Gift

This is same as the narration or purpose of the transaction

senderAmount

double

required

Defaults to 10

This is the sender's amount

senderCurrency

string

required

Defaults to USD

This is the sender's currency. E.g "USD" for US Dollar

senderDetails

object

required

Sender Details

senderMobileNumber

string

required

Defaults to 08036677496

This is the sender's mobile number E.g. +2348036677496

sessionId

string

required

Defaults to 894566054500356867

This is the unique transaction reference

Responses

Language

Credentials

OAuth2


xxxxxxxxxx
73
1
curl --request POST \
2
     --url https://sandbox.paddieswitch.com/api/v1/transactions/remittances/bank-account \
3
     --header 'Content-Type: application/json' \
4
     --header 'accept: application/json' \
5
     --data '
6
{
7
  "accountNumber": "1976010126",
8
  "bankAccountType": "PERSONAL",
9
  "bankCode": "NGA10003",
10
  "bankName": "KEYSTONE BANK",
11
  "beneficiaryAmount": 5700,
12
  "beneficiaryCountry": "NG",
13
  "beneficiaryCurrency": "NGN",
14
  "beneficiaryDetails": {
15
    "address": {
16
      "addressLine1": "20 Lagos Street",
17
      "city": "Lagos",
18
      "country": "NG",
19
      "postalCode": "425277",
20
      "stateProvince": "LA"
21
    },
22
    "email": "test@gmail.com",
23
    "firstName": "Linda",
24
    "fullName": "Linda Naa Adoley Allotey",
25
    "lastName": "Allotey",
26
    "mobileNumber": "+2330551425473"
27
  },
28
  "beneficiaryMobileNumber": "08012345678",
29
  "businessBeneficiaryDetails": {

Click Try It! to start a request and see the response here! Or choose an example:

application/json

200200

400400