GoCardless API API Documentation
Confirm Customer & Bank Account Details
POST {{url}}/billing_requests/{{billing_request}}/actions/confirm_payer_details
If the billing request has a pending collectbankaccount action, this endpoint can be used to collect the details in order to complete it. The endpoint takes the same payload as Customer Bank Accounts, but check the bank account is valid for the billing request scheme before creating and attaching it. Note: Customer bank accounts can be created with local or international bank details. You can find the different local bank detail formats, and how they should be used with the GoCardless API here.
Body
PARAM
| Key | Datatype | Required | Description |
HEADERS
| Key | Datatype | Required | Description |
RESPONSES
status OK
| {
"billing_requests": {
"id": "BRQ0005Y9RTBV78",
"created_at": "2024-03-22T21:31:26.133Z",
"status": "ready_to_fulfil",
"mandate_request": {
"currency": "GBP",
"constraints": null,
"scheme": "bacs",
"sweeping": false,
"verify": "recommended",
"links": {},
"metadata": {
"postman": "mandate-only-br"
},
"description": null,
"payer_requested_dual_signature": false
},
"payment_request": null,
"metadata": {
"test": "BR1"
},
"links": {
"customer": "CU0014DR8N0C49",
"customer_billing_detail": "CBD000JFDXZ7FQD",
"customer_bank_account": "BA000ZP63JF2PP",
"creditor": "CR00006C6DF0TD",
"organisation": "OR00004AE28612",
"mandate_request": "MRQ0005F4V3K31X"
},
"fallback_enabled": false,
"fallback_occurred": false,
"sign_flow_url": null,
"creditor_name": "Ondooo",
"actions": [
{
"type": "choose_currency",
"required": true,
"completes_actions": [],
"requires_actions": [],
"status": "completed",
"available_currencies": [
"USD",
"SEK",
"GBP",
"AUD",
"NZD",
"DKK",
"CAD",
"EUR"
]
},
{
"type": "collect_customer_details",
"required": true,
"completes_actions": [],
"requires_actions": [
"choose_currency"
],
"status": "completed",
"collect_customer_details": {
"incomplete_fields": {
"customer": [],
"customer_billing_detail": []
},
"default_country_code": "GB"
}
},
{
"type": "collect_bank_account",
"required": true,
"completes_actions": [
"choose_currency"
],
"available_country_codes": [
"GB"
],
"requires_actions": [],
"status": "completed"
},
{
"type": "confirm_payer_details",
"required": true,
"completes_actions": [],
"requires_actions": [
"collect_customer_details",
"collect_bank_account"
],
"status": "completed"
},
{
"type": "bank_authorisation",
"required": null,
"completes_actions": [
"collect_bank_account"
],
"requires_actions": [
"select_institution"
],
"status": "pending",
"bank_authorisation": {
"authorisation_type": "mandate",
"adapter": "open_banking_gateway_ais"
}
}
],
"resources": {
"customer": {
Curl curl -X POST 'https://api-sandbox.gocardless.com/billing_requests/billing_request/actions/confirm_payer_details' ENDPOINTS |