Skip to main content
Create VRP Payment
curl --request POST \
  --url https://api.yapily.com/hosted/vrp/consent-requests/{consentRequestId}/payments \
  --header 'Authorization: Basic <encoded-value>' \
  --header 'Content-Type: application/json;charset=UTF-8' \
  --header 'consent-token: <consent-token>' \
  --data '
{
  "paymentIdempotencyId": "234g87t58tgeuo848wudjew489",
  "amount": {
    "amount": 10,
    "currency": "GBP"
  }
}
'
{
  "meta": {
    "tracingId": "d80a638a-635e-11ee-8c99-0242ac120002"
  },
  "data": {
    "id": "string",
    "paymentIdempotencyId": "234g87t58tgeuo848wudjew489",
    "amount": {
      "amount": 10,
      "currency": "GBP"
    },
    "reference": "Test Payment",
    "payee": {
      "name": "Merchant Doe",
      "accountIdentifications": [
        {
          "identification": "401016",
          "type": "SORT_CODE"
        },
        {
          "identification": "71518920",
          "type": "ACCOUNT_NUMBER"
        }
      ]
    },
    "refundAccount": {
      "name": "string",
      "accountIdentifications": [
        {
          "type": "MASKED_ACCOUNT_NUMBER",
          "identification": "*****493"
        }
      ]
    },
    "paymentLifecycleId": "234g87t58tgeuo848wudjew489",
    "institutionPaymentId": "35a4bd02-635e-11ee-8c99-0242ac120002",
    "statusDetails": {
      "status": "PENDING",
      "statusUpdateDate": "2023-10-05T09:00:36.360Z",
      "isoStatus": {
        "code": "PDNG",
        "name": "Pending"
      }
    }
  }
}

Authorizations

Authorization
string
header
required

Use HTTP Basic Authentication with your Application ID as username and Application Secret as password. Manage credentials in the Yapily Console. See Authentication for details.

Headers

Mandatory. The consent-token containing the user's authorisation to make the request.

sub-application
string

The unique identifier of the sub application the request is being submitted on behalf of (e.g. an underlying merchant)

Path Parameters

Unique Identifier of the Consent Request

Body

application/json;charset=UTF-8

Mandatory. The payment request object defining the details of the payment for execution under the Variable Recurring Payment consent.

paymentIdempotencyId
string
required

Mandatory. A unique identifier that you must provide to identify the payment. This can be any alpha-numeric string but is limited to a maximum of 35 characters.

Example:

"04ab4536gaerfc0e1f93c4f4"

amount
Amount Details · object
required

Mandatory. Monetary Amount.

Response

Created

meta
object
data
object