Basic Disbursement

Basic Disbursement

Disburse funds to a payout instrument

Methods

POST

Disburses funds to the payout instrument specified.

Request

Copied!
{
 "type": "object",
 "properties": {
  "instruction": {
   "type": "object",
   "properties": {
    "narrative": {
     "type": "object",
     "properties": {
      "line1": {
       "type": "string"
      },
      "line2": {
       "type": "string"
      }
     },
     "required": [
      "line1"
     ]
    },
    "payoutInstrument": {
     "oneOf": [
      {
       "type": "object",
       "properties": {
        "billingAddress": {
         "type": "object",
         "properties": {
          "address1": {
           "type": "string"
          },
          "address2": {
           "type": "string"
          },
          "address3": {
           "type": "string"
          },
          "city": {
           "type": "string"
          },
          "countryCode": {
           "type": "string"
          },
          "postalCode": {
           "type": "string"
          },
          "state": {
           "type": "string"
          }
         },
         "required": [
          "countryCode",
          "postalCode"
         ]
        },
        "cardExpiryDate": {
         "type": "object",
         "properties": {
          "month": {
           "type": "integer"
          },
          "year": {
           "type": "integer"
          }
         },
         "required": [
          "month",
          "year"
         ]
        },
        "cardHolderName": {
         "type": "string"
        },
        "cardNumber": {
         "type": "string"
        },
        "type": {
         "type": "string"
        }
       },
       "required": [
        "cardExpiryDate",
        "cardNumber",
        "type"
       ]
      },
      {
       "type": "object",
       "properties": {
        "href": {
         "type": "string"
        },
        "type": {
         "type": "string"
        }
       },
       "required": [
        "href",
        "type"
       ]
      },
      {
       "type": "object",
       "properties": {
        "billingAddress": {
         "type": "object",
         "properties": {
          "address1": {
           "type": "string"
          },
          "address2": {
           "type": "string"
          },
          "address3": {
           "type": "string"
          },
          "city": {
           "type": "string"
          },
          "countryCode": {
           "type": "string"
          },
          "postalCode": {
           "type": "string"
          },
          "state": {
           "type": "string"
          }
         },
         "required": [
          "countryCode",
          "postalCode"
         ]
        },
        "cardExpiryDate": {
         "type": "object",
         "properties": {
          "month": {
           "type": "integer"
          },
          "year": {
           "type": "integer"
          }
         },
         "required": [
          "month",
          "year"
         ]
        },
        "cardHolderName": {
         "type": "string"
        },
        "dpan": {
         "type": "string"
        },
        "type": {
         "type": "string"
        }
       },
       "required": [
        "cardExpiryDate",
        "dpan",
        "type"
       ]
      }
     ]
    },
    "value": {
     "type": "object",
     "properties": {
      "amount": {
       "type": "integer"
      },
      "currency": {
       "type": "string"
      }
     },
     "required": [
      "amount",
      "currency"
     ]
    }
   },
   "required": [
    "narrative",
    "payoutInstrument",
    "value"
   ]
  },
  "merchant": {
   "type": "object",
   "properties": {
    "entity": {
     "type": "string"
    }
   },
   "required": [
    "entity"
   ]
  },
  "transactionReference": {
   "type": "string"
  }
 },
 "required": [
  "instruction",
  "merchant",
  "transactionReference"
 ]
}

Responses

Examples

POST
 Successful Basic Disbursement
View
POST
 Unsuccessful Payout request
View
POST
 Successful Basic Disbursement to a token
View
POST
 Successful Basic Disbursement to a decrypted applepay
View

Link relationship

  • payouts:payout

    Retrieve the details of a payout resource.

post
 Successful Basic Disbursement
POSThttps://try.access.worldpay.com/payouts/basicDisbursement
Copied!
{
  "Authorization": "Basic Auth",
  "Content-Type": "application/vnd.worldpay.payouts-v3+json",
  "Accept": "application/vnd.worldpay.payouts-v3+json"
}
Copied!
{
  "merchant": {
    "entity": "default"
  },
  "instruction": {
    "value": {
      "amount": 300,
      "currency": "GBP"
    },
    "payoutInstrument": {
      "type": "card/plain",
      "cardHolderName": "Mr Arjen Lucassen",
      "cardExpiryDate": {
        "month": 1,
        "year": 2025
      },
      "cardNumber": "4444333322221111",
      "billingAddress": {
        "address1": "address1",
        "address2": "address2",
        "address3": "address3",
        "postalCode": "postalCode",
        "city": "city",
        "state": "state",
        "countryCode": "GB"
      }
    },
    "narrative": {
      "line1": "STATEMENT",
      "line2": "OPTIONAL"
    }
  },
  "transactionReference": "transaction-ref"
}

201

Copied!
{
  "outcome": "requestReceived",
  "receivedAt": "2018-09-01T10:37:36.923Z",
  "_links": {
    "payouts:payout": {
      "href": "https://try.access.worldpay.com/payouts/{resource}"
    },
    "curies": [
      {
        "name": "payouts",
        "href": "https://try.access.worldpay.com/rels/payouts/{rel}",
        "templated": true
      }
    ]
  }
}