Make a Payment | Redpin | Documentation

Deprecated: This endpoint is deprecated. Please use Create Payment (v3) instead.

This will initiate the process of sending money to a Recipient. As preparation for this call you could make a GET request to the Recipients resource to check that the recipient has not been deleted.

Payment Processing: The payment is processed in the background, meaning the API returns immediately with a success response containing a payment_id and initial status of “pending”. The actual payment processing continues after the response is returned. To check the current status of the payment, make a GET request to the Review Payments or View a Payment endpoints.

Authentication: Bearer token required

<Warning> **Deprecated**: This endpoint is deprecated. Please use [Create Payment](/api-reference/customers/api-integration/payments/create-payment) (v3) instead. </Warning> This will initiate the process of sending money to a Recipient. As preparation for this call you could make a GET request to the [Recipients](/api-reference/customers/api-integration/recipients/get-recipients) resource to check that the recipient has not been deleted. **Payment Processing:** The payment is processed in the background, meaning the API returns immediately with a success response containing a `payment_id` and initial `status` of "pending". The actual payment processing continues after the response is returned. To check the current status of the payment, make a GET request to the [Review Payments](/api-reference/customers/api-integration/legacy-ap-is/legacy-payments/review-payments) or [View a Payment](/api-reference/customers/api-integration/legacy-ap-is/legacy-payments/view-payment) endpoints. **Authentication:** [Bearer token required](/api-guide/getting-started/authentication#oauth-20-authentication) ```mermaid flowchart TD A[Actor] subgraph I1["Iteration 1"] B["POST /v2/customers/{customerId}/payments"] end subgraph I2["Iteration 2"] C["POST /v2/customers/{customerId}/payments<br/>(with confirm_recipient section)"] end D["Create Payment"] E(("Success")) F(("Stop")) G["Error response<br/>(code and description)"] H["CoP check failed<br/>or any other error"] A --> B A --> C B -->|1| D C -->|3| D D -->|Success| E --> F D -->|2| H --> G --> A ```

Authentication

AuthorizationBearer

OAuth 2.0 Bearer token authentication. This API uses OAuth 2.0 Client Credentials flow. Please refer to the Authentication section for detailed information on how to obtain and use your OAuth credentials.

Path parameters

customer_idstringRequired

Unique Customer Identifier

Request

This endpoint expects an object.

recipient_idstringRequired

The Payee ID used to identify this Recipient.

Reference: Get Recipients

The Payee ID used to identify this Recipient. **Reference:** [Get Recipients](http://localhost:3000/api-reference/customers/api-integration/recipients/get-recipients#response.body.recipients.recipient_id)

purpose_of_transactionstringRequired

Purpose of the transaction. A list of possible values can be obtained with a GET request to the transaction-purpose resource.

Reference: Get Transaction Purposes

amountdoubleRequired

Amount of the payment.

payment_referencestringRequired1-35 characters

Description to appear on the Recipient’s bank statement and should not contain any special character. If recipient is UK based and is a collection account, use payment_reference of recipient. It should not contain any special character.

client_reference_idstringOptional<=36 characters

Unique reference id that you want to assign to this payment for your own purposes.

confirm_recipientobjectOptional

Container for confirmation of recipient details.

This object is required only when the initial API call fails due to a Confirmation of Payee (CoP) or Verification of Payee (VoP) check failure.

If the failure is related to CoP/VoP, the API response will include a details field containing only the recipients whose CoP/VoP checks failed. Each recipient in details field will have a request_identifier and event_id, which must be used in the subsequent retry request along with the appropriate customer_action.

Detailed instructions for handling these scenarios can be found in:

Container for confirmation of recipient details. This object is required only when the initial API call fails due to a [Confirmation of Payee (CoP)](https://www.wearepay.uk/what-we-do/overlay-services/confirmation-of-payee/) or [Verification of Payee (VoP)](https://www.europeanpaymentscouncil.eu/what-we-do/other-schemes/verification-payee) check failure. If the failure is related to CoP/VoP, the API response will include a `details` field containing only the recipients whose CoP/VoP checks failed. Each recipient in `details` field will have a `request_identifier` and `event_id`, which must be used in the subsequent retry request along with the appropriate `customer_action`. Detailed instructions for handling these scenarios can be found in: - [UK Confirmation of Payee (CoP) Guide](/api-guide/regulatory-guides/cop-guide) - [SEPA Verification of Payee (VoP) Guide](/api-guide/regulatory-guides/vop-guide)

Response

Ok. A payment was initiated.

payment_idstring

Payment ID

instruction_numberstring

Unique client reference to identify this conversion in future. The format will be {customerId}-{sequenceNumber}

currency_codestring

Recipient’s Currency Code.

Reference: ISO 4217

Recipient's Currency Code. **Reference:** [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217)

amountdouble

Amount being debited.

recipient_detailsobject

statusstring

Status of this payment.

payment_referencestring

Description to appear on the Recipient's bank statement.

created_datetimedatetime

Timestamp of the payment

payment_datedate

Date when the payment was completed.

1	using RestSharp;
2
3	var client = new RestClient("https://sandbox.currenciesdirect.com/v2/customers/cust_123456789/payments");
4	var request = new RestRequest(Method.POST);
5	request.AddHeader("Authorization", "Bearer <token>");
6	request.AddHeader("Content-Type", "application/json");
7	request.AddParameter("application/json", "{\n \"recipient_id\": \"743512\",\n \"purpose_of_transaction\": \"PENSION\",\n \"amount\": 1.91,\n \"payment_reference\": \"saving 225\",\n \"client_reference_id\": \"987564823645\",\n \"confirm_recipient\": {\n \"customer_action\": \"override\",\n \"request_identifier\": \"123456789\",\n \"event_id\": \"AG-435435454435\"\n }\n}", ParameterType.RequestBody);
8	IRestResponse response = client.Execute(request);

1	{
2	"payment_id": "2908362",
3	"instruction_number": "0202000005923566-000000011",
4	"currency_code": "string",
5	"amount": 51749.42,
6	"recipient_details": {
7	"recipient_id": 743512,
8	"recipient_name": "Bob Nighy",
9	"country_code": "GBR"
10	},
11	"status": "PENDING",
12	"payment_reference": "saving 225",
13	"created_datetime": "2019-01-24T12:38:46Z",
14	"payment_date": "2019-01-24"
15	}

Authentication

Path parameters

Request

Response

Errors